Remove-EntraGroup

Module:
Microsoft.Entra.Groups Module v1.3

Hiermee verwijdert u een groep.

Syntax

Default (Standaard) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Description

Met de Remove-EntraGroup cmdlet wordt een groep uit Microsoft Entra ID verwijderd. Geef de GroupId parameter op waarmee een groep wordt verwijderd.

Unified Group kan 30 dagen na verwijdering worden hersteld met behulp van de Restore-EntraBetaDeletedDirectoryObject cmdlet. Beveiligingsgroepen kunnen niet worden hersteld na verwijdering.

Opmerkingen over machtigingen:

De volgende voorwaarden zijn van toepassing op apps om roltoewijzingsgroepen te verwijderen:

  • Voor gedelegeerde scenario's moet aan de app de RoleManagement.ReadWrite.Directory gedelegeerde machtiging worden toegewezen en moet de aanroepende gebruiker de maker van de groep zijn of ten minste de beheerder van de bevoorrechte rol worden toegewezen Microsoft Entra rol.
  • Voor alleen-app-scenario's moet de aanroepende app de eigenaar van de groep zijn of de RoleManagement.ReadWrite.Directory toepassingsmachtiging zijn toegewezen of ten minste de beheerder van de bevoorrechte rol Microsoft Entra rol worden toegewezen.

Voorbeelden

Voorbeeld 1: Een groep verwijderen

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

In dit voorbeeld ziet u hoe u een groep verwijdert in Microsoft Entra ID.

  • GroupId parameter geeft de groeps-id.

Voorbeeld 2: Een groep verwijderen met behulp van pipelining

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

In dit voorbeeld ziet u hoe u een groep verwijdert in Microsoft Entra ID.

Parameters

-GroupId

Hiermee geeft u de object-id van een groep in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.