Test-RDOUAccess

Test-RDOUAccess

Verifies that the Remote Desktop Connection Broker server can access an Active Directory Domain Services organizational unit.

Syntax

Parameter Set: Default
Test-RDOUAccess [[-Domain] <String> ] [-OU] <String> [[-ConnectionBroker] <String> ] [ <CommonParameters>]

Detailed Description

The Test-RDOUAccess cmdlet verifies that the RD Connection Broker server has access to the organizational units (OUs) in a given domain of Active Directory Domain Services (AD DS).

The RD Connection Broker must have Read access to an OU to query user account information.

Parameters

-ConnectionBroker<String>

Specifies an RD Connection Broker server for a remote desktop deployment. If you do not supply a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.

Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Domain<String>

Specifies the Active Directory (AD) domain for which to verify access.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OU<String>

Specifies one or more OUs for which to verify access.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • System.Object

Examples

Example 1: Verify access to an OU

This command tests access to an OU named Computers by the RD Connection Broker server named Rdcb.Contoso.com.

PS C:\> Test-RDOUaccess -ConnectionBroker "Rdcb.Contoso.com" -OU "Computers"

Grant-RDOUAccess