Remove-EntraGroup

Moduł:
Microsoft.Entra.Groups Module v1.3

Usuwa grupę.

Składnia

Default (domyślnie) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Opis

Polecenie Remove-EntraGroup cmdlet usuwa grupę z Microsoft Entra ID. GroupId Określ parametr usuwa grupę.

Grupę Ujednoliconą można przywrócić z 30 dni po usunięciu Restore-EntraBetaDeletedDirectoryObject przy użyciu polecenia cmdlet . Nie można przywrócić grup zabezpieczeń po usunięciu.

Uwagi dotyczące uprawnień:

Następujące warunki dotyczą aplikacji w celu usunięcia grup z możliwością przypisywania ról:

  • W przypadku scenariuszy delegowanych aplikacja musi mieć przypisane RoleManagement.ReadWrite.Directory uprawnienie delegowane, a użytkownik wywołujący musi być twórcą grupy lub mieć przypisaną co najmniej rolę Administrator ról uprzywilejowanych Microsoft Entra.
  • W przypadku scenariuszy tylko dla aplikacji aplikacja wywołująca musi być właścicielem grupy lub mieć przypisane RoleManagement.ReadWrite.Directory uprawnienie aplikacji lub mieć przypisaną co najmniej rolę administrator ról uprzywilejowanych Microsoft Entra.

Przykłady

Przykład 1. Usuwanie grupy

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

W tym przykładzie pokazano, jak usunąć grupę w Microsoft Entra ID.

  • GroupId parametr określa identyfikator grupy .

Przykład 2. Usuwanie grupy przy użyciu potokowania

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

W tym przykładzie pokazano, jak usunąć grupę w Microsoft Entra ID.

Parametry

-GroupId

Określa identyfikator obiektu grupy w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.