< Back

Get-VIPermission

Sun Jan 19, 2020 6:53 pm

NAME Get-VIPermission



SYNOPSIS

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





SYNTAX

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





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

-Entity <VIObject[]>

Specifies the inventory items for which you want to retrieve permissions.



Required? false

Position? 1

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? true



-Principal <VIAccount[]>

Specifies the users and groups for which you want to retrieve permissions.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? true



-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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? true



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

Zero or more Permission objects







NOTES





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



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



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



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



RELATED LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... ssion.html

New-VIPermission

Remove-VIPermission

Set-VIPermission

Get-VIPrivilege https://code.vmware.com/doc/preview?id= ... ilege.html

Get-VIRole

New-VIRole

Remove-VIRole

Set-VIRole