Get-AdministrativeUnit

Этот командлет работает только в облачной службе.

Используйте командлет Get-AdministrativeUnit для просмотра административных единиц, которые представляют собой контейнеры ресурсов Azure Active Directory. Административные единицы можно использовать для делегирования административных разрешений и применения политик к различным группам пользователей.

Примечание. Административные единицы доступны только в Azure Active Directory Premium. Вы создаете административные единицы и управляете ими в Microsoft Graph PowerShell.

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

Синтаксис

Get-AdministrativeUnit
   [[-Identity] <AdministrativeUnitIdParameter>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1

Get-AdministrativeUnit

В этом примере возвращается сводный список всех административных единиц Azure Active Directory.

Пример 2

Get-AdministrativeUnit -Identity "West Coast" | Format-List

В этом примере возвращаются подробные сведения об административной единице с отображаемым именем "Западное побережье".

Параметры

-Confirm

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

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-Identity

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

  • Отображаемое имя (это же значение в Microsoft Graph PowerShell)
  • ExternalDirectoryObjectId (это значение GUID совпадает со свойством ObjectId в Microsoft Graph PowerShell)
  • имя (значение GUID);
  • различающееся имя (DN);
  • GUID (значение, отличное от имени)
Type:AdministrativeUnitIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

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

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