< Back

Get-AzureStorSimpleAccessControlRecord

Wed Jan 30, 2019 5:45 pm

NAME Get-AzureStorSimpleAccessControlRecord



SYNOPSIS

Gets access control records in a service configuration.





SYNTAX

Get-AzureStorSimpleAccessControlRecord [[-ACRName] <String>] [-Profile <Microsoft.Azure.Common.Authentication.Models.AzureProfile>] [<CommonParameters>]





DESCRIPTION

The Get-AzureStorSimpleAccessControlRecord cmdlet gets access control records in the StorSimple Manager service configuration. This cmdlet gets all

records or a named record.



Access control records are containers of iSCSI initiator parameters. These parameters specify which initiators can access a volume. When an iSCSI

initiator attempts to connect to a volume, your appliance checks the access control records assigned to that volume. If the iSCSI initiator parameters

match one of the entries in an access control record mapped to that volume, the iSCSI initiator can connect.





PARAMETERS

-ACRName [<String>]

Specifies the name of an access control record to get.



Required? false

Position? 1

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



<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

AccessControlRecord, IList<AccessControlRecord>



This cmdlet returns an AccessControlRecord object or an IList<AccessControlRecord> object. An AccessControlRecord object contains the following

fields:



-- GlobalId (String)

-- InitiatorName (String)

-- InstanceId (String)

-- Name (String)

-- OperationInProgress (OperationInProgress)

-- VolumeCount (int)





NOTES





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



Example 1: Get all access control records



PS C:\\>Get-AzureStorSimpleAccessControlRecord

InstanceId Name InitiatorName VolumeCount

---------- ---- ------------- -----------

01a31aa5-14de-4b77-b926-2842577f540e Windows_XYUSFL718-RV_ACR iqn.1991-05.com.microsof... 3

071c282d-0cd2-4c5f-b687-48966037ba48 Linux_XYUSFL719_ACR iqn.1994-05.com.redhat:a... 3

4600eade-71f8-4d04-baec-0e7cf1d1e8fb Windows_XYUSFL720_ACR iqn.1991-05.com.microsof... 9

d508d6f0-fcda-4624-b223-c0b307d6113e Linux_XYUSFL350_ACR iqn.1991-05.com.microsof... 9



This command gets all access control records.





Example 2: Get a specific access control record



PS C:\\>Get-AzureStorSimpleAccessControlRecord -ACRName "Acr11"

VERBOSE: ClientRequestId: 61f261c7-acd3-4bcc-922a-ddfd85eb767b_PS

VERBOSE: ClientRequestId: 49c6a4c7-d299-46fd-a553-034c52b47487_PS



GlobalId :

InitiatorName : iqn-contoso63

InstanceId : 55f24643-ab3a-4098-ade2-aa2b1a3ab18c

Name : Acr11

OperationInProgress : None

VolumeCount : 6



VERBOSE: Access Control Record with given name Acr11 is found!



This command gets the access control record named Acr11.







RELATED LINKS

New-AzureStorSimpleAccessControlRecord

Remove-AzureStorSimpleAccessControlRecord

Set-AzureStorSimpleAccessControlRecord