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 Get-LocalUser cmdlet 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.

Uwaga

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 Administracja Contoso02.

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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-SID

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

Type:SecurityIdentifier[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 programu Get-LocalUser:

  • glu

Właściwość PrincipalSource w obiektach LocalUser, LocalGroup i LocalPrincipal opisuje źródło obiektu. Możliwe źródła są następujące:

  • Lokalny
  • Active Directory
  • Grupa Microsoft Entra
  • Microsoft Account

JednostkaSource 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.