Partilhar via

Add-LocalGroupMember

Módulo:
Microsoft.PowerShell.LocalAccounts Module

Adiciona membros a um grupo local.

Sintaxe

Group 

Add-LocalGroupMember
    [-Group] <LocalGroup>
    [-Member] <LocalPrincipal[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

Add-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-Name] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SecurityIdentifier 

Add-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-SID] <SecurityIdentifier>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Add-LocalGroupMember adiciona usuários ou grupos a um grupo de segurança local. Todos os direitos e permissões atribuídos a um grupo são atribuídos a todos os membros desse grupo.

Os membros do grupo Administradores num computador local têm permissões de Controlo Total nesse computador. Limite o número de usuários no grupo Administradores.

Se o computador estiver associado a um domínio, pode adicionar contas de utilizador, contas de computador e contas de grupo desse domínio e de domínios fidedignos a um grupo local.

Observação

Se o computador estiver associado a um domínio e tentar adicionar um utilizador local que tenha o mesmo nome que um membro do domínio, este adiciona o membro do domínio.

Exemplos

Exemplo 1: Adicionar membros ao grupo Administradores

Este comando adiciona vários membros ao grupo Administradores local. Os novos membros incluem uma conta de usuário local, uma conta da Microsoft, uma conta do Microsoft Entra e um grupo de domínio. Este exemplo usa um valor de espaço reservado para o nome de usuário de uma conta em Outlook.com.

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

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Group

Especifica o grupo de segurança ao qual esse cmdlet adiciona membros.

Propriedades dos parâmetros

Tipo:Microsoft.PowerShell.Commands.LocalGroup
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Group
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Member

Especifica uma matriz de usuários ou grupos que esse cmdlet adiciona a um grupo de segurança. Você pode especificar usuários ou grupos por nome, ID de segurança (SID) ou objetos LocalPrincipal.

Propriedades dos parâmetros

Tipo:

Microsoft.PowerShell.Commands.LocalPrincipal[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

Especifica o nome do grupo de segurança ao qual esse cmdlet adiciona membros.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Default
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SID

Especifica a ID de segurança do grupo de segurança ao qual esse cmdlet adiciona membros.

Propriedades dos parâmetros

Tipo:SecurityIdentifier
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SecurityIdentifier
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

System.Management.Automation.SecurityAccountsManager.LocalGroup

Você pode canalizar uma entidade local para esse cmdlet.

String

Você pode canalizar uma cadeia de caracteres para este cmdlet.

SecurityIdentifier

Você pode canalizar um SID para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

O Windows PowerShell inclui os seguintes aliases para Add-LocalGroupMember:

  • algm

O módulo Microsoft.PowerShell.LocalAccounts não está disponível no PowerShell de 32 bits em um sistema de 64 bits.

A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroupe LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:

  • Locais
  • Active Directory
  • Grupo Microsoft Entra
  • Conta Microsoft

PrincipalSource é suportado apenas pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.