Add-LocalGroupMember
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 em um computador local têm permissões de Controle Total nesse computador. Limite o número de usuários no grupo Administradores.
Se o computador estiver ingressado em um domínio, você poderá adicionar contas de usuário, contas de computador e contas de grupo desse domínio e de domínios confiáveis a um grupo local.
Observação
Se o computador estiver ingressado em um domínio e você tentar adicionar um usuário local que tenha o mesmo nome que um membro do domínio, ele adicionará o membro do domínio.
Exemplos
Exemplo 1: Adicionar membros ao grupo Administradores
Esse comando adiciona vários membros ao grupo de 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 sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Group
Especifica o grupo de segurança ao qual esse cmdlet adiciona membros.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.Commands.LocalGroup |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Group
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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, SID (ID de segurança) ou objetos localPrincipal.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome do grupo de segurança ao qual esse cmdlet adiciona membros.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SID
Especifica a ID de segurança do grupo de segurança ao qual esse cmdlet adiciona membros.
Propriedades do parâmetro
| Tipo: | SecurityIdentifier |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SecurityIdentifier
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 de segurança local para este cmdlet.
String
Você pode encaminhar uma cadeia de caracteres para este cmdlet.
SecurityIdentifier
Você pode canalizar um SID para este cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
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:
- Local
- Active Directory
- Grupo do Microsoft Entra
- Conta da Microsoft
PrincipalSource tem suporte apenas pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Em versões anteriores, a propriedade está em branco.
