Remove-EntraAdministrativeUnit

模組:
Microsoft.Entra.DirectoryManagement Module v1.3

移除一個行政單位。

語法

Default (預設值) 

Remove-EntraAdministrativeUnit

    -AdministrativeUnitId <String>
    [<CommonParameters>]

Description

該Remove-EntraAdministrativeUnit指令檔會移除 Microsoft Entra ID 中的一個管理單元。 指定 AdministrativeUnitId 參數來刪除一個行政單位。

要刪除管理單元，呼叫主體必須至少擁有 Microsoft Entra 中的特權角色管理員（Privileged Role Administrator）。

範例

範例 1：移除行政單位

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrative-unit-display-name>'"
Remove-EntraAdministrativeUnit -AdministrativeUnitId $administrativeUnit.Id

此指令會將指定的管理單元從 Microsoft Entra ID 中移除。

  • -AdministrativeUnitId 參數指定行政單位的識別碼。

範例 2：透過管線移除管理單元

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrative-unit-display-name>'" | Remove-EntraAdministrativeUnit

此指令會將指定的管理單元從 Microsoft Entra ID 中移除。

參數

-AdministrativeUnitId

指定 Microsoft Entra ID 中管理單元的 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ObjectId (物件識別碼)

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。