Partager via

Get-LocalUser

  • Référence
Module:
Microsoft.PowerShell.LocalAccounts

Obtient les comptes d’utilisateur locaux.

Syntaxe

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

Description

L’applet Get-LocalUser de commande obtient des comptes d’utilisateur locaux. Cette applet de commande obtient les comptes d’utilisateur intégrés par défaut, les comptes d’utilisateur locaux que vous avez créés et les comptes locaux que vous avez connectés aux comptes Microsoft.

Remarque

Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.

Exemples

Exemple 1 : Obtenir un compte à l’aide de son nom

Cet exemple obtient un compte d’utilisateur nommé AdminContoso02.

Get-LocalUser -Name "AdminContoso02"

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

Exemple 2 : Obtenir un compte connecté à un compte Microsoft

Cet exemple obtient un compte d’utilisateur connecté à un compte Microsoft. Cet exemple utilise une valeur d’espace réservé pour le nom d’utilisateur d’un compte à Outlook.com.

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

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

Exemple 3 : Obtenir un compte qui a le SID spécifié

Cet exemple obtient un compte d’utilisateur local qui a le SID spécifié.

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

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

Paramètres

-Name

Spécifie un tableau de noms de comptes d’utilisateur que cette applet de commande obtient. Vous pouvez utiliser le caractère générique.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-SID

Spécifie un tableau d’ID de sécurité (SID) de comptes d’utilisateur que cette applet de commande obtient.

Type:SecurityIdentifier[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger une chaîne vers cette applet de commande.

SecurityIdentifier

Vous pouvez diriger un SID vers cette applet de commande.

Sorties

System.Management.Automation.SecurityAccountsManager.LocalUser[]

Cette applet de commande retourne des comptes d’utilisateur locaux.

Notes

Windows PowerShell inclut les alias suivants pour Get-LocalUser:

  • glu

La propriété PrincipalSource sur les objets LocalUser, LocalGroup et LocalPrincipal décrit la source de l’objet. Les sources possibles sont les suivantes :

  • Local
  • Active Directory
  • Groupe Microsoft Entra
  • Compte Microsoft

PrincipalSource est pris en charge uniquement par Windows 10, Windows Server 2016 et versions ultérieures du système d’exploitation Windows. Pour les versions antérieures, la propriété est vide.