New-AzureStorSimpleAccessControlRecord

NAME New-AzureStorSimpleAccessControlRecord



SYNOPSIS

Creates an access control record.





SYNTAX

New-AzureStorSimpleAccessControlRecord [-ACRName] <String> [-IQNInitiatorName] <String> [[-WaitForComplete]] [-Profile

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





DESCRIPTION

The New-AzureStorSimpleAccessControlRecord cmdlet creates an access control record. You can use an AccessControlRecord object to configure volumes.





PARAMETERS

-ACRName <String>

Specifies a name for the access control record.



Required? true

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-IQNInitiatorName <String>

Specifies the iSCSI qualified name (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



-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: Create an Access Controlaccess control record and wait for the resultaccess control



PS C:\\>New-AzureStorSimpleAccessControlRecord -ACRName "Acr10" -IQNInitiatorName "Iqn10" -WaitForComplete

Error : Microsoft.WindowsAzure.Management.StorSimple.Models.ErrorDetails

JobId : 08719243-3a76-43a5-a88b-e5f2b63ed3d9

JobSteps : {}

Result : Succeeded

Status : Completed

TaskResult : Succeeded

StatusCode : OK

RequestId : e12362c2c06615108ba8436cf85fcd40



This command creates an access control record named Acr10 for the iSCSI initiator named Iqn10. This command specifies the WaitForComplete parameter,

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





Example 2: Create an Access Controlaccess control recordaccess control



PS C:\\>New-AzureStorSimpleAccessControlRecord -ACRName "Acr11" -IQNInitiatorName "Iqn11"

VERBOSE: The create job is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId

2bd56fbb-4b95-4f2c-b99f-6321231a018d for tracking the job status



This command creates an access control record named Acr11 for the iSCSI initiator named Iqn11. This command does not specify the WaitForComplete

parameter, and, therefore, the command starts the task, and then returns a TaskResponse object. To see the status of the task, use the

Get-AzureStorSimpleTask cmdlet.







RELATED LINKS

Get-AzureStorSimpleAccessControlRecord

Remove-AzureStorSimpleAccessControlRecord

Set-AzureStorSimpleAccessControlRecord

Get-AzureStorSimpleJob