Set-AzureStorSimpleAccessControlRecord

NAME Set-AzureStorSimpleAccessControlRecord



SYNOPSIS

Updates the IQN of an access control record.





SYNTAX

Set-AzureStorSimpleAccessControlRecord [-ACRName] <String> [-IQNInitiatorName] <String> [[-WaitForComplete]] [[-NewName] <System.String>] [-Profile

<Microsoft.Azure.Common.Authentication.Models.AzureProfile>] [<CommonParameters>]





DESCRIPTION

The Set-AzureStorSimpleAccessControlRecord cmdlet updates the iSCSI qualified name (IQN) of an existing access control record.





PARAMETERS

-ACRName <String>

Specifies a name of the access control record to modify.



Required? true

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-IQNInitiatorName <String>

Specifies the IQN of the iSCSI initiator to which this cmdlet provides access for the volume.



Required? true

Position? 2

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-NewName [<System.String>]

Specifies a new name for access control record.



Required? false

Position? 4

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]

Specifies an Azure profile.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-WaitForComplete [<SwitchParameter>]

Indicates that this cmdlet waits for the operation to complete before it returns control to the Windows PowerShell????????? console.



Required? false

Position? 3

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None









OUTPUTS

TaskStatusInfo, TaskResponse



This cmdlet returns a TaskStatusInfo object if you specify the WaitForComplete parameter. If you do not specify that parameter, it returns a

TaskResponse object.





NOTES





Keywords: azure, azuresm, servicemanagement, management, service, store, storsimple



Example 1: Update an access control record



PS C:\\>Set-AzureStorSimpleAccessControlRecord -ACRName "Acr10" -IQNInitiatorName "IqnUpdated" -WaitForComplete

VERBOSE: ClientRequestId: e4766335-f302-40e0-93bf-fad7aa488ae6_PS

VERBOSE: ClientRequestId: cfdbbd67-6ba5-4238-b743-b88f604079b9_PS

VERBOSE: About to run a task to update your Access Control Record!

VERBOSE: ClientRequestId: d5cf2793-0ab5-40ff-ab6f-43e21bc4c0a4_PS





JobId : 89502523-52fc-4ce2-b2d4-cb8c6692fb60

JobResult : Succeeded

JobStatus : Completed

ErrorCode :

ErrorMessage :

JobSteps : {}



VERBOSE: The job created for your update operation has completed successfully.

VERBOSE: ClientRequestId: cbd47519-3a3c-4365-b097-0fb7551c48ee_PS

GlobalId :

InitiatorName : IqnUpdated

InstanceId : 9bcfbc83-e196-4688-9016-827f51515c24

Name : Acr10

OperationInProgress : None

VolumeCount : 0



This command updates the access control record named Acr10 for the iSCSI initiator named IqnUpdated. This command specifies the WaitForComplete

parameter, and, therefore, the command waits until the operation is complete, and then returns a TaskStatusInfo object.







RELATED LINKS

Get-AzureStorSimpleAccessControlRecord

New-AzureStorSimpleAccessControlRecord

Remove-AzureStorSimpleAccessControlRecord