Partilhar via

Get-LocalUser

Módulo:
Microsoft.PowerShell.LocalAccounts Module

Obtém contas de usuário locais.

Sintaxe

Default (Predefinição) 

Get-LocalUser
    [[-Name] <String[]>]
    [<CommonParameters>]

SecurityIdentifier 

Get-LocalUser
    [[-SID] <SecurityIdentifier[]>]
    [<CommonParameters>]

Description

O cmdlet Get-LocalUser obtém contas de usuário locais. Este cmdlet obtém contas de usuário internas padrão, contas de usuário locais que você criou e contas locais que você conectou a contas da Microsoft.

Observação

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

Exemplos

Exemplo 1: Obter uma conta usando seu nome

Este exemplo obtém uma conta de usuário chamada AdminContoso02.

Get-LocalUser -Name "AdminContoso02"

Name             Enabled Description
----             ------- -----------
AdminContoso02   True    Description of this account.

Exemplo 2: Obter uma conta ligada a uma conta Microsoft

Este exemplo obtém uma conta de usuário conectada a uma conta da Microsoft. Este exemplo usa um valor de espaço reservado para o nome de usuário de uma conta em Outlook.com.

Get-LocalUser -Name "MicrosoftAccount\username@Outlook.com"

Name                                    Enabled  Description
----                                    -------  -----------
MicrosoftAccount\username@outlook.com  True     Description of this account.

Exemplo 3: Obter uma conta que tenha o SID especificado

Este exemplo obtém uma conta de usuário local que tem o SID especificado.

Get-LocalUser -SID S-1-5-21-9526073513-1762370368-3942940353-500

Name          Enabled Description
----          ------- -----------
Administrator True    Built-in account for administering the computer/domain

Parâmetros

-Name

Especifica uma matriz de nomes de contas de usuário que esse cmdlet obtém. Você pode usar o caractere curinga.

Propriedades dos parâmetros

Tipo:

String[]

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

Conjuntos de parâmetros

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

-SID

Especifica uma matriz de IDs de segurança (SIDs) de contas de usuário que esse cmdlet obtém.

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:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
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

String

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

SecurityIdentifier

Você pode canalizar um SID para este cmdlet.

Saídas

System.Management.Automation.SecurityAccountsManager.LocalUser

Este cmdlet retorna contas de usuário locais.

Notas

O Windows PowerShell inclui os seguintes aliases para Get-LocalUser:

  • glu

A propriedade PrincipalSource em LocalUser , LocalGroup e objetos LocalPrincipal 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.