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

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

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.


Copyright © VMware, Inc. All rights reserved.