Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Remove-EntraAdministrativeUnit

Removes an administrative unit.

Syntax

Default (Default) 

Remove-EntraAdministrativeUnit

 -AdministrativeUnitId <String>
 [<CommonParameters>]

Description

The Remove-EntraAdministrativeUnit cmdlet removes an administrative unit from Microsoft Entra ID. Specify AdministrativeUnitId parameter to delete an administrative unit.

To delete an administrative unit, the calling principal must have at least the Privileged Role Administrator role in Microsoft Entra.

Examples

Example 1: Remove an administrative unit

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

This command removes the specified administrative unit from Microsoft Entra ID.

  • -AdministrativeUnitId parameter specifies the ID of an administrative unit.

Example 2: Remove an administrative unit through pipelining

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

This command removes the specified administrative unit from Microsoft Entra ID.

Parameters

-AdministrativeUnitId

Specifies the ID of an administrative unit in Microsoft Entra ID.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:ObjectId

Parameter sets

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Related Links

Feedback

Was this page helpful?