Get-OrganizationalUnit

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Get-OrganizationalUnit для просмотра списка подразделений, существующих в организации.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-OrganizationalUnit
   [[-Identity] <ExtendedOrganizationalUnitIdParameter>]
   [-SingleNodeOnly]
   [-DomainController <Fqdn>]
   [-IncludeContainers]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-OrganizationalUnit
   [-SearchText <String>]
   [-DomainController <Fqdn>]
   [-IncludeContainers]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Описание

Командлет Get-OrganizationalUnit используется Центром администрирования Exchange для заполнения полей, отображающих сведения об подразделении.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

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

В этом примере выполняется получение списка дочерних подразделений первого уровня, которые находятся ниже подразделения "Северная Америка". Выводимые данные затем форматируются таким образом, чтобы отображались только свойства Name и DistinguishedName.

Дополнительные сведения о конвейерной работе и командлете Format-Table см. в разделах Сведения о конвейерах и Работа с выходными данными команд.

Пример 2

Get-OrganizationalUnit -SearchText "Executives" | Format-Table Name, DistinguishedName

В этом примере извлекается список подразделений, соответствующих текстовой строке "Руководители", и выходные данные форматируются так, чтобы отображались только свойства Name и DistinguishedName.

Параметры

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Параметр Identity указывает подразделение или домен, которые необходимо просмотреть. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:

Имя
Имя
различающееся имя (DN);
GUID

Вы можете использовать этот параметр вместе с параметром SearchText.

Type:	ExtendedOrganizationalUnitIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeContainers

Параметр IncludeContainers указывает на необходимость возврата контейнеров в результатах. Указывать значение для этого параметра необязательно.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchText

Параметр SearchText разрешает поиск указанной строки в названиях всех подразделений организации. Возвращаются только подразделения, которые соответствуют указанной строке. Если указанная строка содержит пробелы, ее необходимо заключить в кавычки (").

Имя базы данных

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SingleNodeOnly

Переключатель SingleNodeOnly указывает на необходимость возврата только дочерних подразделений первого уровня, располагающихся ниже указанного в параметре Identity подразделения. Указывать значение для этого параметра необязательно.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.