Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Set-AzureStorSimpleAccessControlRecord

Set-AzureStorSimpleAccessControlRecord

microsoft.windowsazure.commands.storsimple.dll

Synopsis

Updates the IQN of an access control record.

Syntax

Set-AzureStorSimpleAccessControlRecord [-ACRName] [-IQNInitiatorName] [-WaitForComplete] [-NewName] [-Profile] [<CommonParameters>]

Detailed 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.

Aliases

Name

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.

Aliases

IQN

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.

Aliases

none

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.

Aliases

none

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.

Aliases

none

Required?

false

Position

3

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

None

Return Type

TaskStatusInfo, TaskResponse

Notes

None

Examples

Example 1: Update an access control record

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.

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

Get-AzureStorSimpleAccessControlRecord
New-AzureStorSimpleAccessControlRecord
Remove-AzureStorSimpleAccessControlRecord