Remove-EntraGroup

Modul:
Microsoft.Entra.Groups Module v1.3

Entfernt eine Gruppe.

Syntax

Default (Standard) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Beschreibung

Das Remove-EntraGroup Cmdlet entfernt eine Gruppe aus Microsoft Entra ID. Geben Sie an, dass der GroupId Parameter eine Gruppe entfernt.

Einheitliche Gruppe kann 30 Tage nach dem Löschen mithilfe des Restore-EntraBetaDeletedDirectoryObject Cmdlets wiederhergestellt werden. Sicherheitsgruppen können nach dem Löschen nicht wiederhergestellt werden.

Hinweise zu Berechtigungen:

Die folgenden Bedingungen gelten für Apps zum Löschen von Gruppen, die Rollen zugewiesen werden können:

  • Für delegierte Szenarien muss die App die RoleManagement.ReadWrite.Directory delegierte Berechtigung zugewiesen werden, und der aufrufende Benutzer muss der Ersteller der Gruppe sein oder mindestens der Rolle "Privilegierter Rollenadministrator" Microsoft Entra Rolle zugewiesen werden.
  • Für Nur-App-Szenarien muss die aufrufende App der Besitzer der Gruppe sein oder der RoleManagement.ReadWrite.Directory Anwendungsberechtigung zugewiesen sein oder mindestens dem Administrator für privilegierte Rollen Microsoft Entra Rolle zugewiesen werden.

Beispiele

Beispiel 1: Entfernen einer Gruppe

Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Remove-EntraGroup -GroupId $group.Id

In diesem Beispiel wird veranschaulicht, wie eine Gruppe in Microsoft Entra ID entfernt wird.

  • GroupId der Parameter gibt die Gruppen-ID an.

Beispiel 2: Entfernen einer Gruppe mithilfe von Pipelining

Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'" | Remove-EntraGroup

In diesem Beispiel wird veranschaulicht, wie eine Gruppe in Microsoft Entra ID entfernt wird.

Parameter

-GroupId

Gibt die Objekt-ID einer Gruppe 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.