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.