Get-VIPermission Command | Vmware PowerCLI Reference

Get-VIPermission

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.

Syntax

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

Parameters

Required Parameter Name Type Position Features Description
optional Entity VIObject[] named
  • pipeline
  • wildcards
Specifies the inventory items for which you want to retrieve permissions.
optional Principal VIAccount[] named
  • wildcards
Specifies the users and groups for which you want to retrieve permissions.
optional Server VIServer[] named
  • wildcards
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null 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.

Output

VMware.VimAutomation.ViCore.Types.V1.PermissionManagement.Permission

Examples

Example 1

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

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

Related Commands

VIPermission

This cmdlet retrieves the permissions defined on the specified inventory objects.

This cmdlet creates new permissions on the specified inventory objects for the provided users and groups in the role.

This cmdlet removes the specified permissions.

This cmdlet modifies the properties of the specified permissions.