Udostępnij za pośrednictwem

Get-LocalUser

  • Odwołanie
Moduł:
Microsoft.PowerShell.LocalAccounts

Pobiera konta użytkowników lokalnych.

Składnia

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

Opis

Polecenie cmdlet Get-LocalUser pobiera konta użytkowników lokalnych. To polecenie cmdlet pobiera domyślne wbudowane konta użytkowników, utworzone konta użytkowników lokalnych i konta lokalne połączone z kontami Microsoft.

Nuta

Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.

Przykłady

Przykład 1. Uzyskiwanie konta przy użyciu jego nazwy

Ten przykład pobiera konto użytkownika o nazwie AdminContoso02.

Get-LocalUser -Name "AdminContoso02"

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

Przykład 2. Uzyskiwanie konta połączonego z kontem Microsoft

W tym przykładzie jest używane konto użytkownika połączone z kontem Microsoft. W tym przykładzie użyto wartości zastępczej dla nazwy użytkownika konta w Outlook.com.

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

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

Przykład 3. Pobieranie konta z określonym identyfikatorem SID

W tym przykładzie jest używane konto użytkownika lokalnego z określonym identyfikatorem SID.

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

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

Parametry

-Name

Określa tablicę nazw kont użytkowników pobieranych przez to polecenie cmdlet. Możesz użyć symbolu wieloznacznych.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-SID

Określa tablicę identyfikatorów zabezpieczeń (SID) kont użytkowników pobieranych przez to polecenie cmdlet.

Typ:SecurityIdentifier[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz przekazać ciąg do tego polecenia cmdlet.

SecurityIdentifier

Do tego polecenia cmdlet można przekazać identyfikator SID.

Dane wyjściowe

System.Management.Automation.SecurityAccountsManager.LocalUser[]

To polecenie cmdlet zwraca konta użytkowników lokalnych.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla Get-LocalUser:

  • glu

Właściwość PrincipalSource w LocalUser, LocalGroupi localPrinci pal obiektów opisuje źródło obiektu. Możliwe źródła są następujące:

  • Lokalny
  • Active Directory
  • Grupa Microsoft Entra
  • Konto Microsoft

PrincipalSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.