vSphere PowerCLI Reference

Get-VIPermission

Synopsis

Retrieves the permissions defined on the specified inventory objects.

Syntax

Get-VIPermission [[-Entity] <VIObject[]>] [-Principal <VIAccount[]>] [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online version
New-VIPermission
Remove-VIPermission
Set-VIPermission
Get-VIRrivilege
Get-VIRole
New-VIRole
Remove-VIRole
Set-VIRole

Detailed Description

Retrieves the permissions defined on the specified inventory objects. If no inventory objects are specified, the cmdlet retrieves all permissions available on the server.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
EntityVIObject[]Specify the inventory items for which you want to retrieve permissions.falsetrue (ByValue)
PrincipalVIAccount[]Specify the users and groups for which you want to retrieve permissions.falsefalse
ServerVIServer[]Specify the vSphere 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-VIServer.falsefalse

Return Type

Permission

Notes

You can specify permissions to a datastore only on vSphere 4.0 and later.

Examples

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

Get-VIPermission -Entity (Get-Datacenter) -Principal Administrator

Retrieves the permissions of the Administrator user on the provided datacenters.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.