Remove-EntraAdministrativeUnit

Modul:
Microsoft.Entra.DirectoryManagement Module v1.3

Entfernt eine administrative Einheit.

Syntax

Default (Standard) 

Remove-EntraAdministrativeUnit

    -AdministrativeUnitId <String>
    [<CommonParameters>]

Beschreibung

Das Remove-EntraAdministrativeUnit Cmdlet entfernt eine administrative Einheit aus Microsoft Entra ID. Geben Sie AdministrativeUnitId den Parameter an, um eine administrative Einheit zu löschen.

Um eine Administrative Einheit zu löschen, muss der aufrufende Prinzipal mindestens über die Rolle "Privileged Role Administrator" in Microsoft Entra verfügen.

Beispiele

Beispiel 1: Entfernen einer administrativen Einheit

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

Mit diesem Befehl wird die angegebene administrative Einheit aus Microsoft Entra ID entfernt.

  • -AdministrativeUnitId der Parameter gibt die ID einer administrativen Einheit an.

Beispiel 2: Entfernen einer administrativen Einheit durch Pipelining

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

Mit diesem Befehl wird die angegebene administrative Einheit aus Microsoft Entra ID entfernt.

Parameter

-AdministrativeUnitId

Gibt die ID einer administrativen Einheit in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.