Compartir a través de

Remove-LocalGroup

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Elimina grupos de seguridad locales.

Sintaxis

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.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

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

Tipo:Microsoft.PowerShell.Commands.LocalGroup[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

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

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SID

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

Tipo:SecurityIdentifier[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.