Add-LocalGroupMember
Adiciona membros a um grupo local.
Sintaxe
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
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.
Nota
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 a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Group
Especifica o grupo de segurança ao qual esse cmdlet adiciona membros.
Tipo: | Microsoft.PowerShell.Commands.LocalGroup |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Name
Especifica o nome do grupo de segurança ao qual esse cmdlet adiciona membros.
Tipo: | String |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SID
Especifica a ID de segurança do grupo de segurança ao qual esse cmdlet adiciona membros.
Tipo: | SecurityIdentifier |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
System.Management.Automation.SecurityAccountsManager.LocalGroup
Você pode canalizar uma entidade de segurança local para este cmdlet.
Você pode canalizar uma cadeia de caracteres para este cmdlet.
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 em LocalUser, LocalGroupe objetos 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. Para versões anteriores, a propriedade está em branco.