Product Documentation

Test-BrokerRemotePCAccountNameAvailable

Oct 01, 2013

Determine whether the proposed RemotePCAccount OU is available for use.

Syntax

Test-BrokerRemotePCAccountNameAvailable [-OU] <String[]> [-AdminAddress <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.

Related topics

Get-BrokerRemotePCAccount

New-BrokerRemotePCAccount

Rename-BrokerRemotePCAccount

Parameters

-OU<String[]>

The RemotePCAccount OU to be tested.

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

-AdminAddress<String>

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.

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

Input Type

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

Return Values

Citrix.Broker.Admin.SDK.NameAvailability

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.

Examples

-------------------------- 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.