Citrix Virtual Apps and Desktops SDK

Get-Admineffectiveadministrator

Retrieve the effective administrator objects for a user.

Syntax

Get-AdminEffectiveAdministrator [-Name] <String> [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

This command determines what groups the specified user belongs to and retrieves the matching administrator records. It includes the set of rights that would be granted to the user if he or she used the system.

As this command uses Active Directory to determine what groups the user has, the caller must have the ability to read this information from Active Directory.

Only enabled administrator records are returned.

Parameters

Name Description Required? Pipeline Input Default Value
Name User name or ID of user to query true true (ByValue)  
BearerToken Specifies the bearer token assigned to the calling user false false  
TraceParent Specifies the trace parent assigned for internal diagnostic tracing use false false  
TraceState Specifies the trace state assigned for internal diagnostic tracing use false false  
VirtualSiteId Specifies the virtual site the PowerShell snap-in will connect to. false false  
AdminAddress Specifies the address of a XenDesktop controller the PowerShell snap-in will connect to. You can provide this as a host name or an IP address. false false Localhost. Once a value is provided by any cmdlet, this value becomes the default.

Input Type

String

User name or ID of user to query

Return Values

Citrix.Delegatedadmin.Sdk.Administrator

Administrator records matching the specified user

Examples

Example 1

C:\PS> Get-AdminEffectiveAdministrator MYDOMAIN\testuser
<!--NeedCopy-->

Description

Retrieve the administrator records matching user ‘testuser’.

Get-Admineffectiveadministrator