Get-LocalUser

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Získá místní uživatelské účty.

Syntax

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

Description

Rutina Get-LocalUser získá místní uživatelské účty. Tato rutina získá výchozí předdefinované uživatelské účty, místní uživatelské účty, které jste vytvořili, a místní účty, které jste připojili k účtům Microsoft.

Poznámka:

Modul Microsoft.PowerShell.LocalAccounts není k dispozici v 32bitovém PowerShellu v 64bitovém systému.

Příklady

Příklad 1: Získání účtu pomocí jeho názvu

Tento příklad získá uživatelský účet s názvem Správa Contoso02.

Get-LocalUser -Name "AdminContoso02"

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

Příklad 2: Získání účtu, který je připojený k účtu Microsoft

Tento příklad získá uživatelský účet, který je připojený k účtu Microsoft. Tento příklad používá zástupnou hodnotu pro uživatelské jméno účtu na Outlook.com.

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

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

Příklad 3: Získání účtu se zadaným identifikátorem SID

Tento příklad získá místní uživatelský účet, který má zadaný identifikátor 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

Určuje pole názvů uživatelských účtů, které tato rutina získá. Můžete použít zástupný znak.

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

-SID

Určuje pole ID zabezpečení (SID) uživatelských účtů, které tato rutina získá.

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

Vstupy

String

Do této rutiny můžete zamísit řetězec.

SecurityIdentifier

Identifikátor SID můžete do této rutiny převést.

Výstupy

System.Management.Automation.SecurityAccountsManager.LocalUser[]

Tato rutina vrací místní uživatelské účty.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Get-LocalUser:

  • glu

Vlastnost PrincipalSource pro LocalUser, LocalGroup a LocalPrincipal objekty popisuje zdroj objektu. Možné zdroje jsou následující:

  • Místní
  • Active Directory
  • Skupina Microsoft Entra
  • Účet Microsoft

PrincipalSource podporuje jenom Windows 10, Windows Server 2016 a novější verze operačního systému Windows. U starších verzí je tato vlastnost prázdná.