Citrix Virtual Apps and Desktops SDK

Set-Hypadminconnection

Set the controller to be used by the cmdlets that form the Host service PowerShell snap-in.

Syntax

Set-HypAdminConnection [-AdminAddress <String>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

Use this command to set the default controller address to be used by the cmdlets to communicate with the controller. Most Host service cmdlets take an ‘AdminAddress’ parameter that can be used to define the controller (when used, this overrides this setting). However, the Set-Location cmdlet in the Host service provider does not offer this option. Therefore, the controller address must be set using this cmdlet, if no other cmdlets have set the address previously in the current runspace.

Parameters

Name Description Required? Pipeline Input Default Value
AdminAddress Specifies the address of a XenDesktop controller to which the PowerShell snap-in connects. 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.
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  

Input Type

Return Values

Examples

Example 1

c:\PS>Set-HypAdminConnection -AdminAddress myserver.com
<!--NeedCopy-->

Description

This command sets the controller address for the commands to be “myserver.com”. All commands run use this address until it is altered, either by another call to this command or by the use of the ‘AdminAddress’ parameter in another command in the Host service snap-in.

Set-Hypadminconnection