Remove-EntraGroup

Módulo:
Microsoft.Entra.Groups Module v1.3

Quita un grupo.

Sintaxis

Default (valor predeterminado) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Description

El Remove-EntraGroup cmdlet quita un grupo de Microsoft Entra ID. Especifique el GroupId parámetro quita un grupo.

El grupo unificado se puede restaurar con 30 días después de la eliminación mediante el Restore-EntraBetaDeletedDirectoryObject cmdlet . Los grupos de seguridad no se pueden restaurar después de la eliminación.

Notas sobre los permisos:

Las siguientes condiciones se aplican para que las aplicaciones eliminen grupos asignables a roles:

  • En escenarios delegados, la aplicación debe tener asignado el RoleManagement.ReadWrite.Directory permiso delegado y el usuario que llama debe ser el creador del grupo o asignar al menos el rol Administrador de roles con privilegios Microsoft Entra.
  • En escenarios de solo aplicación, la aplicación que llama debe ser el propietario del grupo o tener asignado el RoleManagement.ReadWrite.Directory permiso de aplicación o tener asignado al menos el rol Administrador de roles con privilegios Microsoft Entra.

Ejemplos

Ejemplo 1: Quitar un grupo

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

En este ejemplo se muestra cómo quitar un grupo en Microsoft Entra ID.

  • GroupId el parámetro especifica el identificador de grupo .

Ejemplo 2: Quitar un grupo mediante la canalización

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

En este ejemplo se muestra cómo quitar un grupo en Microsoft Entra ID.

Parámetros

-GroupId

Especifica el identificador de objeto de un grupo en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.