Product Documentation


Oct 21, 2016

Retrieves the scopes where the specified operation is permitted.


Test-AdminAccess [-Operation] <String> [-AdminAddress <String>] [<CommonParameters>]

Detailed Description

This cmdlet evaluates what rights the current user has, and from these determines the scopes where the specified operation is permitted.

Operations are the indivisible unit of functionality that each XenDesktop service can perform, and usually correspond to individual cmdlets.

Related topics



The operation to query.

Required? true
Default Value  
Accept Pipeline Input? true (ByValue)


Specifies the address of a XenDesktop controller the PowerShell snap-in connects to. You can provide this as a host name or an IP address.

Required? false
Default Value Localhost. Once a value is provided by any cmdlet, this value becomes the default.
Accept Pipeline Input? false

Return Values


The list of permissible scopes for the specified operation.


If the specified operation has unrestricted access a single object is returned representing the 'All' scope with a ScopeId of Guid.Empty (00000000-0000-0000-0000-000000000000).


-------------------------- EXAMPLE 1 --------------------------

C:\PS> Test-AdminAccess -Operation 'Broker:GetCatalog'

Queries the scopes where 'Broker:GetCatalog' is permitted.