Compartir a través de

Get-LocalUser

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Obtiene las cuentas de usuario locales.

Sintaxis

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

Description

El Get-LocalUser cmdlet obtiene cuentas de usuario locales. Este cmdlet obtiene cuentas de usuario integradas predeterminadas, cuentas de usuario locales que creó y cuentas locales que ha conectado a cuentas microsoft.

Nota:

El módulo Microsoft.PowerShell.LocalAccounts no está disponible en PowerShell de 32 bits en un sistema de 64 bits.

Ejemplos

Ejemplo 1: Obtener una cuenta con su nombre

En este ejemplo se obtiene una cuenta de usuario denominada AdminContoso02.

Get-LocalUser -Name "AdminContoso02"

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

Ejemplo 2: Obtener una cuenta conectada a una cuenta Microsoft

En este ejemplo se obtiene una cuenta de usuario que está conectada a una cuenta Microsoft. En este ejemplo se usa un valor de marcador de posición para el nombre de usuario de una cuenta en Outlook.com.

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

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

Ejemplo 3: Obtener una cuenta que tenga el SID especificado

En este ejemplo se obtiene una cuenta de usuario local que tiene el 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 una matriz de nombres de cuentas de usuario que obtiene este cmdlet. Puede usar el carácter comodín.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-SID

Especifica una matriz de identificadores de seguridad (SID) de cuentas de usuario que obtiene este cmdlet.

Tipo:SecurityIdentifier[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena a este cmdlet.

SecurityIdentifier

Puede canalizar un SID a este cmdlet.

Salidas

System.Management.Automation.SecurityAccountsManager.LocalUser[]

Este cmdlet devuelve cuentas de usuario locales.

Notas

Windows PowerShell incluye los siguientes alias para Get-LocalUser:

  • glu

La propiedad PrincipalSource en objetos LocalUser, LocalGroup y LocalPrincipal describe 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.