The Host station name can include strings in the form %MACRO%, and these macros are substituted at runtime for the correct values. This complements the $MACRO$ feature in PHSETUP, which provides a one-time substitution at PHSETUP runtime.
This feature may be useful when creating a Host image for deployment, either using the Deployment Tool or via imaging of the entire disk. The macro names supported are:
Macro
Description
%PIN%
Unique 6-digit code corresponding to this Host
%NAME%
Host computer machine name
%USER%
Logged in user at the Host machine console in Windows “<domain>\<username>” format
%USERNAME%
Logged in user at the Host machine console in “<username>” only format
%USERUPN%
Logged in user at the Host machine console in UPN (universal principal name) format, or blank if not a domain account
%USERUPN+%
Same as %USERUPN%, except provides %USER% value for local account
%USERDISPLAY%
Logged in user at the Host machine console account display name
%USERDISPLAY+%
Same as %USERDISPLAY%, except provides %USER% value if account display name is blank
%USEREMAIL%
Logged in user at the Host machine console account email address, or blank if not a domain account or not configured in Active Directory
%USEREMAIL+%
Same as %USEREMAIL%, except provides %USER% value if account email address is blank
%VER%
External Host software version number (e.g. what About box displays)
%INTVER%
Internal Host software version number (e.g. what file version information displays, may be different from the About box version)
%PLATFORM%
Host operating system platform (e.g. “Win7”)
%PID%
Process ID of the Host service
The following macros are available for customizing station name for Hosts running in Remote Desktop Services sessions. They should be applied in the RDS Host Control Panel template but can also be specified in the root Host Control Panel (see RDS tab for more information).
Macro
Description
%CLIENTNAME%
Machine name that the client of the RDS session has connected from, or the name of the server machine (same as %NAME%) if the session is not a RDS instance
%CLIENTADDR%
IP address that the client of the RDS session has connected from, or the IP address of the server machine (same as %ADDR%) if the session is not a RDS instance
%SESSION%
RDS session number. This will be 0 (zero) for the root Host instance, and non-zero for RDS instances.
