Remove-EntraGroup

模块:
Microsoft.Entra.Groups Module v1.3

删除组。

语法

Default (默认值) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

说明

该 Remove-EntraGroup cmdlet 从Microsoft Entra ID中删除组。 GroupId指定参数可删除组。

使用 cmdlet 删除后 Restore-EntraBetaDeletedDirectoryObject ，可以使用 30 天还原统一组。 删除后无法还原安全组。

有关权限的说明：

以下条件适用于删除可分配角色的组的应用：

  • 对于委派方案，必须为应用分配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 参数指定组 ID 。

示例 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。