Remove-EntraAdministrativeUnit

Module:: Microsoft.Entra Module v1.1

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

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	True
Value from remaining arguments:	False

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.