Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2012-11-19

Use the Get-OrganizationalUnit cmdlet to view a list of organizational units (OUs) that exist in your organization.

Syntax

Get-OrganizationalUnit [-Identity <ExtendedOrganizationalUnitIdParameter>] [-DomainController <Fqdn>] [-IncludeContainers <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-SingleNodeOnly <SwitchParameter>]

Detailed Description

The Get-OrganizationalUnit cmdlet is used by the Exchange Management Console and the Exchange Control Panel in Microsoft Exchange Server 2010 to populate fields that display OU information.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Active Directory Domain Services server settings" entry in the Exchange and Shell Infrastructure Permissions topic.

Parameters

Parameter Required Type Description

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.ExtendedOrganizationalUnitIdParameter

The Identity parameter specifies the OU to retrieve. If the OU name contains spaces, enclose the value in quotation marks (").

IncludeContainers

Optional

System.Management.Automation.SwitchParameter

The IncludeContainers switch instructs the command to return containers while returning a list of OUs.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

This parameter is available for multi-tenant deployments. It isn't available for on-premises deployments. For more information about multi-tenant deployments, see Multi-Tenant Support.

The Organization parameter specifies the organization in which you'll perform this action. This parameter doesn't accept wildcard characters, and you must use the exact name of the organization.

SingleNodeOnly

Optional

System.Management.Automation.SwitchParameter

The SingleNodeOnly switch instructs the command to return only the first level child OUs beneath the OU specified in the Identity parameter.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

Examples

EXAMPLE 1

This example retrieves a list of the first level child OUs beneath the North America OU and formats the output so that only the Name and DistinguishedName properties are displayed.

Copy Code
Get-OrganizationalUnit "North America" -SingleNodeOnly | Format-Table Name, DistinguishedName

For more information about pipelining and the Format-Table cmdlet, see Pipelining and Working with Command Output.