Compartir a través de


Remove-LocalGroupMember

Quita miembros de un grupo local.

Sintaxis

Remove-LocalGroupMember
      [-Group] <LocalGroup>
      [-Member] <LocalPrincipal[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-Name] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-SID] <SecurityIdentifier>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El Remove-LocalGroupMember cmdlet quita usuarios o grupos de un grupo local.

Nota:

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

Ejemplos

Ejemplo 1: Quitar miembros del grupo Administradores

$members = "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
Remove-LocalGroupMember -Group "Administrators" -Member $members

Este comando quita varios miembros del grupo administradores local. Los miembros que quita este cmdlet incluyen una cuenta de usuario local, una cuenta microsoft, una cuenta de Microsoft Entra y un grupo de dominios. En este ejemplo se usa un valor de marcador de posición para el nombre de usuario de una cuenta en Outlook.com.

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

-Group

Especifica el grupo de seguridad del que este cmdlet quita miembros.

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

-Member

Especifica una matriz de usuarios o grupos que este cmdlet quita de un grupo de seguridad. Puede especificar usuarios o grupos por nombre, identificador de seguridad (SID) o objetos LocalPrincipal . Especifique cadenas de SID en S-R-I-S-S-S . . . format.

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

-Name

Especifica el nombre del grupo de seguridad del que este cmdlet quita miembros.

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

-SID

Especifica el identificador de seguridad del grupo de seguridad del que este cmdlet quita miembros.

Tipo:SecurityIdentifier
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
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.LocalPrincipal

Puede canalizar una entidad de seguridad local 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-LocalGroupMember:

  • rlgm

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.