Freigeben über

Get-LocalUser

  • Referenz
Modul:
Microsoft.PowerShell.LocalAccounts

Ruft lokale Benutzerkonten ab.

Syntax

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

Beschreibung

Das Get-LocalUser Cmdlet ruft lokale Benutzerkonten ab. Dieses Cmdlet ruft standardmäßig integrierte Benutzerkonten, lokale Benutzerkonten, die Sie erstellt haben, und lokale Konten ab, die Sie mit Microsoft-Konten verbunden haben.

Hinweis

Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.

Beispiele

Beispiel 1: Abrufen eines Kontos mithilfe seines Namens

In diesem Beispiel wird ein Benutzerkonto namens "AdminContoso02" angezeigt.

Get-LocalUser -Name "AdminContoso02"

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

Beispiel 2: Abrufen eines Kontos, das mit einem Microsoft-Konto verbunden ist

In diesem Beispiel wird ein Benutzerkonto angezeigt, das mit einem Microsoft-Konto verbunden ist. In diesem Beispiel wird ein Platzhalterwert für den Benutzernamen eines Kontos bei Outlook.com verwendet.

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

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

Beispiel 3: Abrufen eines Kontos mit der angegebenen SID

In diesem Beispiel wird ein lokales Benutzerkonto mit der angegebenen SID angezeigt.

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

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

Parameter

-Name

Gibt ein Array von Namen von Benutzerkonten an, die dieses Cmdlet abruft. Sie können das Wildcardzeichen verwenden.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-SID

Gibt ein Array von Sicherheits-IDs (SIDs) von Benutzerkonten an, die dieses Cmdlet abruft.

Typ:SecurityIdentifier[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.

SecurityIdentifier

Sie können eine SID an dieses Cmdlet weiterleiten.

Ausgaben

System.Management.Automation.SecurityAccountsManager.LocalUser[]

Dieses Cmdlet gibt lokale Benutzerkonten zurück.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Get-LocalUser:

  • glu

Die PrincipalSource-Eigenschaft für LocalUser-, LocalGroup- und LocalPrincipal-Objekte beschreibt die Quelle des Objekts. Die möglichen Quellen sind wie folgt:

  • Lokal
  • Active Directory
  • Microsoft Entra-Gruppe
  • Microsoft-Konto

PrincipalSource wird nur von Windows 10, Windows Server 2016 und höheren Versionen des Windows-Betriebssystems unterstützt. Bei früheren Versionen ist die Eigenschaft leer.