Remove-EntraGroup

Modulo:
Microsoft.Entra.Groups Module v1.3

Rimuove un gruppo.

Sintassi

Default (Impostazione predefinita) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Descrizione

Il Remove-EntraGroup cmdlet rimuove un gruppo da Microsoft Entra ID. Specificare il GroupId parametro rimuove un gruppo.

Unified Group può essere ripristinato con 30 giorni dopo l'eliminazione usando il Restore-EntraBetaDeletedDirectoryObject cmdlet . I gruppi di sicurezza non possono essere ripristinati dopo l'eliminazione.

Note sulle autorizzazioni:

Le condizioni seguenti si applicano alle app per eliminare i gruppi assegnabili ai ruoli:

  • Per gli scenari delegati, all'app deve essere assegnata l'autorizzazione RoleManagement.ReadWrite.Directory delegata e l'utente chiamante deve essere l'autore del gruppo o deve essere assegnato almeno il ruolo Di amministratore ruolo con privilegi Microsoft Entra.
  • Per gli scenari solo app, l'app chiamante deve essere il proprietario del gruppo o essere assegnata all'autorizzazione RoleManagement.ReadWrite.Directory dell'applicazione o deve essere assegnata almeno al ruolo Di amministratore ruolo con privilegi Microsoft Entra.

Esempio

Esempio 1: Rimuovere un gruppo

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

In questo esempio viene illustrato come rimuovere un gruppo in Microsoft Entra ID.

  • GroupId parametro specifica l'ID gruppo .

Esempio 2: Rimuovere un gruppo tramite pipelining

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

In questo esempio viene illustrato come rimuovere un gruppo in Microsoft Entra ID.

Parametri

-GroupId

Specifica l'ID oggetto di un gruppo in Microsoft Entra ID.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ObjectId

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.