Remove-LocalGroup

删除本地安全组。

语法

Remove-LocalGroup
      [-InputObject] <LocalGroup[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-Name] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-SID] <SecurityIdentifier[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-LocalGroup cmdlet 删除本地安全组。 此 cmdlet 仅删除本地组。 它不会删除属于该组的用户帐户、计算机帐户或组帐户。 无法恢复已删除的组。

如果删除组,然后创建具有相同组名称的另一个组,则必须为新组设置新权限。 新组不会继承分配给该组的权限。

注意

Microsoft.PowerShell.LocalAccounts 模块在 64 位系统上的 32 位 PowerShell 中不可用。

示例

示例 1:删除安全组

Remove-LocalGroup -Name "SecurityGroup04"

此命令删除名为 SecurityGroup04 的组。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定此 cmdlet 删除的安全组数组。 若要获取组,请使用 Get-LocalGroup cmdlet。

类型:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定此 cmdlet 删除的安全组的名称数组。

类型:String[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SID

指定此 cmdlet 删除的安全组的安全 ID(SID)数组。

类型:SecurityIdentifier[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

System.Management.Automation.SecurityAccountsManager.LocalGroup

可以通过管道将安全组传递给此 cmdlet。

String

可以通过管道将字符串传递给此 cmdlet。

SecurityIdentifier

可以通过管道将 SID 传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。

备注

Windows PowerShell 包含以下 Remove-LocalGroup别名:

  • rlg

此 cmdlet 无法删除以下默认组:

  • 管理员
  • 备份运算符
  • 加密运算符
  • 分布式 COM 用户
  • 事件日志读取器
  • 客人
  • Hyper-V 管理员
  • IIS_IUSRS
  • 网络配置作员
  • 性能日志用户
  • 性能监视器用户
  • Power Users
  • 远程桌面用户
  • 远程管理用户
  • 复制器
  • 用户
  • WinRMRemoteWMIUsers__

PrincipalSource 属性是 用于描述对象的源的 localUserLocalGroupLocalPrincipal 对象的属性。 可能的源如下所示:

  • 当地
  • Active Directory
  • Microsoft Entra 组
  • Microsoft 帐户

PrincipalSource 仅受 Windows 10、Windows Server 2016 和更高版本的 Windows作系统支持。 对于早期版本,该属性为空。