Dela via

Get-LocalUser

Modul:
Microsoft.PowerShell.LocalAccounts Module

Hämtar lokala användarkonton.

Syntax

Default (Standard) 

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

SecurityIdentifier 

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

Description

Cmdleten Get-LocalUser hämtar lokala användarkonton. Den här cmdleten hämtar inbyggda standardkonton, lokala användarkonton som du har skapat och lokala konton som du har anslutit till Microsoft-konton.

Anmärkning

Modulen Microsoft.PowerShell.LocalAccounts är inte tillgänglig i 32-bitars PowerShell i ett 64-bitarssystem.

Exempel

Exempel 1: Hämta ett konto med dess namn

Det här exemplet hämtar ett användarkonto med namnet AdminContoso02.

Get-LocalUser -Name "AdminContoso02"

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

Exempel 2: Hämta ett konto som är anslutet till ett Microsoft-konto

Det här exemplet hämtar ett användarkonto som är anslutet till ett Microsoft-konto. I det här exemplet används ett platshållarvärde för användarnamnet för ett konto på Outlook.com.

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

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

Exempel 3: Hämta ett konto som har angivet SID

Det här exemplet hämtar ett lokalt användarkonto som har angivet 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

Parametrar

-Name

Anger en matris med namn på användarkonton som den här cmdleten hämtar. Du kan använda jokertecknet.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

Default
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SID

Anger en matris med säkerhets-ID:er (SID) för användarkonton som den här cmdleten hämtar.

Parameteregenskaper

Typ:

SecurityIdentifier[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SecurityIdentifier
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Du kan skicka en sträng till den här cmdleten.

SecurityIdentifier

Du kan skicka ett SID till den här cmdleten.

Utdata

System.Management.Automation.SecurityAccountsManager.LocalUser

Den här cmdleten returnerar lokala användarkonton.

Kommentarer

Windows PowerShell innehåller följande alias för Get-LocalUser:

  • glu

Egenskapen PrincipalSource på LocalUser, LocalGroupoch LocalPrincipal-objekt beskriver objektets källa. Möjliga källor är följande:

  • Lokal
  • Active Directory
  • Microsoft Entra-grupp
  • Microsoft-konto

PrincipalSource stöds endast av Windows 10, Windows Server 2016 och senare versioner av Windows-operativsystemet. För tidigare versioner är egenskapen tom.