Compartir a través de

Remove-LocalGroup

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Elimina grupos de seguridad locales.

Syntax

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

Description

El Remove-LocalGroup cmdlet elimina los grupos de seguridad locales. Este cmdlet elimina solo un grupo local. No elimina las cuentas de usuario, las cuentas de equipo ni las cuentas de grupo que pertenecen a ese grupo. No se puede recuperar un grupo eliminado.

Si elimina un grupo y, a continuación, crea otro grupo que tenga el mismo nombre de grupo, debe establecer nuevos permisos para el nuevo grupo. El nuevo grupo no hereda los permisos asignados al grupo.

Nota:

El módulo Microsoft.PowerShell.LocalAccounts no está disponible en PowerShell de 32 bits en un sistema de 64 bits.

Ejemplos

Ejemplo 1: Eliminación de un grupo de seguridad

Remove-LocalGroup -Name "SecurityGroup04"

Este comando elimina el grupo denominado SecurityGroup04.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica una matriz de grupos de seguridad que elimina este cmdlet. Para obtener grupos, use el Get-LocalGroup cmdlet .

Type:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica una matriz de nombres de los grupos de seguridad que elimina este cmdlet.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SID

Especifica una matriz de identificadores de seguridad (SID) de grupos de seguridad que elimina este cmdlet.

Type:SecurityIdentifier[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

System.Management.Automation.SecurityAccountsManager.LocalGroup

Puede canalizar un grupo de seguridad a este cmdlet.

String

Puede canalizar una cadena a este cmdlet.

SecurityIdentifier

Puede canalizar un SID a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Windows PowerShell incluye los siguientes alias para Remove-LocalGroup:

  • rlg

Este cmdlet no puede eliminar los siguientes grupos predeterminados:

  • Administradores
  • Operadores de copias de seguridad
  • Operadores criptográficos
  • Usuarios de COM distribuido
  • Lectores del registro de eventos
  • Invitados
  • Administradores de Hyper-V
  • IIS_IUSRS
  • Operadores de configuración de red
  • Usuarios del registro de rendimiento
  • Usuarios de Monitor de rendimiento
  • Usuarios avanzados
  • Usuarios de escritorio remoto
  • Usuarios de Administración remota
  • Duplicadores
  • Usuarios
  • WinRMRemoteWMIUsers__

La propiedad PrincipalSource es una propiedad en objetos LocalUser, LocalGroup y LocalPrincipal que describen el origen del objeto. Los orígenes posibles son los siguientes:

  • Local
  • Active Directory
  • Grupo de Microsoft Entra
  • Cuenta Microsoft

PrincipalSource solo es compatible con Windows 10, Windows Server 2016 y versiones posteriores del sistema operativo Windows. Para versiones anteriores, la propiedad está en blanco.