vSphere PowerCLI Cmdlets 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-VIPrivilege
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

NameDescriptionRequired?Pipeline InputDefault Value
EntitySpecify the inventory items for which you want to retrieve permissions.falsetrue (ByValue)
PrincipalSpecify the users and groups for which you want to retrieve permissions.falsefalse
ServerSpecify 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 - 2010 VMware, Inc. All rights reserved.