PowerCLI Reference

Get-VIPermission

Synopsis

This cmdlet 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-VIPrivilege
Get-VIRole
New-VIRole
Remove-VIRole
Set-VIRole

Detailed Description

This cmdlet 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

Name	Type	Description	Required?	Pipeline Input
Entity	VIObject[]	Specifies the inventory items for which you want to retrieve permissions.	false	True (ByValue)
Principal	VIAccount[]	Specifies the users and groups for which you want to retrieve permissions.	false	False
Server	VIServer[]	Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.	false	False

Return Type

Zero or more Permission objects

Notes

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

Examples

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

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

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