Citrix Virtual Apps and Desktops SDK


Determine whether the proposed RemotePCAccount OU is available for use.


Test-BrokerRemotePCAccountNameAvailable [-OU] <String[]> [-AdminAddress <String>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [<CommonParameters>]

Detailed Description

This cmdlet checks whether proposed RemotePCAccount OU is available for use. It returns a record for each OU indicating the availability of that OU, with $true indicating that the OU is unused and available for use, or $false if it is not available.


Name Description Required? Pipeline Input Default Value
OU The RemotePCAccount OU to be tested. true true (ByValue, ByPropertyName)  
AdminAddress Specifies the address of a XenDesktop controller that the PowerShell snapin will connect to. This can be provided as a host name or an IP address. false false Localhost. Once a value is provided by any cmdlet, this value will become 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  
VirtualSiteId Specifies the virtual site the PowerShell snap-in will connect to. false false  

Input Type


You can pipe a string that contains the OU to test.

Return Values


The cmdlet returns a result for each OU specified. An availability of “True” indicates the OU is available for use, and “False” if it is not available.


Example 1

C:\PS> Test-BrokerRemotePCAccountNameAvailable -OU Test1


Checks whether the OU “Test1” is available.

Example 2

C:\PS> Test-BrokerRemotePCAccountNameAvailable @("Test1","Test2","Test3")


Checks whether each of the specified names is available.