Share via

Add-LocalGroupMember

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Agrega miembros a un grupo local.

Syntax

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

Description

El Add-LocalGroupMember cmdlet agrega usuarios o grupos a un grupo de seguridad local. Todos los derechos y permisos asignados a un grupo se asignan a todos los miembros de ese grupo.

Los miembros del grupo Administración istrators en un equipo local tienen permisos de control total en ese equipo. Limite el número de usuarios del grupo Administración istrators.

Si el equipo está unido a un dominio, puede agregar cuentas de usuario, cuentas de equipo y cuentas de grupo de ese dominio y de dominios de confianza a un grupo local.

Nota:

Si el equipo está unido a un dominio e intenta agregar un usuario local que tenga el mismo nombre que un miembro del dominio, agrega el miembro del dominio.

Ejemplos

Ejemplo 1: Agregar miembros al grupo de Administración istrators

Este comando agrega varios miembros al grupo local Administración istrators. Los nuevos miembros incluyen una cuenta de usuario local, una cuenta microsoft, una cuenta de Microsoft Entra y un grupo de dominio. En este ejemplo se usa un valor de marcador de posición para el nombre de usuario de una cuenta en Outlook.com.

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

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 al que este cmdlet agrega 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 agrega a un grupo de seguridad. Puede especificar usuarios o grupos por nombre, identificador de seguridad (SID) o objetos LocalPrincipal .

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 al que este cmdlet agrega 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 al que este cmdlet agrega 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.LocalGroup

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 Add-LocalGroupMember:

  • algm

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

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.