## PowerCLI Reference

# Get-CIAccessControlRule

## Synopsis

This cmdlet retrieves access control rules.

Syntax

Get-CIAccessControlRule [[-Entity] <AccessControlledEntity[]>] [-AccessLevelAtLeast <AccessLevel>] [-User <CIObject[]>] [-Server <CIServer[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [<CommonParameters>]

Related Commands

Online version
New-CIAccessControlRule
Set-CIAccessControlRule
Remove-CIAccessControlRule

Detailed Description

This cmdlet retrieves access control rules.

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
Entity | AccessControlledEntity[] | Specifies the entities for which you want to retrieve access control rules. This parameter accepts vApp and Catalog objects. | false | true (ByValue)
AccessLevelAtLeast | AccessLevel | Specifies the lowest access level for the access control rules that you want to retrieve. The cmdlet returns all objects with the specified access level and higher access levels, if any. | false | false
InformationAction | ActionPreference |  | false | false
InformationVariable | String |  | false | false
PipelineVariable | String |  | false | false
Server | CIServer[] | Specifies the cloud servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-CIServer. | false | false
User | CIObject[] | Specifies cloud users to retrieve the access control rules that apply for them. This parameter accepts CIUser and Org objects. When you pass an Org object to the parameter, the operation retrieves only access control rules that are set to apply for everyone in the organization. | false | false

Return Type

Zero or more CIAccessControlRule objects

Notes

Examples

-------------- Example 1 --------------

    Get-CIAccessControlRule -Entity 'MyVApp', 'MyCatalog'

Retrieve all access control rules for the specified entities.

-------------- Example 2 --------------

    Get-CIAccessControlRule -User 'MyUser1', 'MyUser2'

Retrieve all access control rules that apply for the specified users.

-------------- Example 3 --------------

    Get-CIAccessControlRule -Entity 'MyCatalog' -User 'MyUser'

Retrieve all access control rules set for the specified catalog and applying only for the specified user.

-------------- Example 4 --------------

    Get-CIAccessControlRule -AccessLevelAtLeast ReadWrite

Retrieve all access control rules with "Read/Write" or "Full Control" access levels that apply for everyone in the MyOrg organization.

Copyright © VMware, Inc. All rights reserved.