Share via

Remove-LocalGroupMember

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Quita miembros de un grupo local.

Syntax

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 Administración istrators

$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 local Administración istrators. 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.

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

-Group

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

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-Name

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

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

-SID

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

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:False
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.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.