Remove-EntraGroup
移除群組。
語法
Default (預設值)
Remove-EntraGroup
-GroupId <String>
[<CommonParameters>]
Description
該Remove-EntraGroup指令長會從 Microsoft Entra ID 中移除一個群組。 指定 GroupId 參數 移除一個群組。
Unified Group 可在刪除後 30 天內使用 Restore-EntraBetaDeletedDirectoryObject cmdlet 恢復。 安全群組在刪除後無法恢復。
關於權限的說明:
以下條件適用於刪除可指派角色群組的應用程式:
- 對於委派情境,應用程式必須被賦予
RoleManagement.ReadWrite.Directory委派權限,呼叫使用者必須是群組的創建者,或至少被指派 Microsoft Entra 特權角色管理員。 - 對於僅應用程式的情境,呼叫的應用程式必須是群組的擁有者,或被賦予
RoleManagement.ReadWrite.Directory應用程式權限,或至少被指派 Microsoft Entra 的特權角色管理員。
範例
範例 1:移除一個群組
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Remove-EntraGroup -GroupId $group.Id
此範例示範如何在 Microsoft Entra ID 中移除群組。
-
GroupId參數指定群組識別碼。
範例 2:使用管線法移除群組
Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'" | Remove-EntraGroup
此範例示範如何在 Microsoft Entra ID 中移除群組。
參數
-GroupId
指定 Microsoft Entra ID 中群組的物件 ID。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ObjectId (物件識別碼) |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。