Freigeben über

Get-LocalUser

Modul:
Microsoft.PowerShell.LocalAccounts Module

Ruft lokale Benutzerkonten ab.

Syntax

Default (Standard) 

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

SecurityIdentifier 

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

Beschreibung

Das Cmdlet Get-LocalUser 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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

Default
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SID

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

Parametereigenschaften

Typ:

SecurityIdentifier[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SecurityIdentifier
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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 eigenschaft PrincipalSource on LocalUser, LocalGroup, and LocalPrincipal objects describes the source of the object. 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.