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。