Get-AdministrativeUnit

此 cmdlet 仅在基于云的服务中有效。

使用 Get-AdministrativeUnit cmdlet 查看管理单元,即 Azure Active Directory 资源容器。 可以使用管理单元来委托管理权限,并将策略应用于不同的用户组。

注意:管理单元仅在Azure Active Directory Premium中可用。 在 Microsoft Graph PowerShell 中创建和管理管理单元。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

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

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-AdministrativeUnit

此示例返回所有 Azure Active Directory 管理单元的摘要列表。

示例 2

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

此示例返回显示名称为 West Coast 的管理单元的详细信息。

参数

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 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 中可用。

保留此参数以供 Microsoft 内部使用。

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 值与 Microsoft Graph PowerShell 中的 ObjectId 属性相同)
  • 名称(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