Udostępnij przez

Get-LocalUser

Moduł:
Microsoft.PowerShell.LocalAccounts Module

Pobiera konta użytkowników lokalnych.

Składnia

Default (domyślnie) 

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

SecurityIdentifier 

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.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

Default
Position:0
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-SID

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

Właściwości parametru

Typ:

SecurityIdentifier[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SecurityIdentifier
Position:0
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

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.