Compartir a través de

Add-LocalGroupMember

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Agrega miembros a un grupo local.

Sintaxis

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 Administradores de un equipo local tienen permisos de Control total en ese equipo. Limite el número de usuarios del grupo Administradores.

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 Administradores

Este comando agrega varios miembros al grupo administradores local. 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.

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

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