다음을 통해 공유

Get-LocalUser

모듈:
Microsoft.PowerShell.LocalAccounts Module

로컬 사용자 계정을 가져옵니다.

구문

Default (기본값) 

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

SecurityIdentifier 

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

Description

Get-LocalUser cmdlet은 로컬 사용자 계정을 가져옵니다. 이 cmdlet은 기본 제공 사용자 계정, 사용자가 만든 로컬 사용자 계정 및 Microsoft 계정에 연결한 로컬 계정을 가져옵니다.

비고

Microsoft.PowerShell.LocalAccounts 모듈은 64비트 시스템의 32비트 PowerShell에서 사용할 수 없습니다.

예제

예제 1: 이름을 사용하여 계정 가져오기

이 예제에서는 AdminContoso02라는 사용자 계정을 가져옵니다.

Get-LocalUser -Name "AdminContoso02"

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

예제 2: Microsoft 계정에 연결된 계정 가져오기

이 예제에서는 Microsoft 계정에 연결된 사용자 계정을 가져옵니다. 이 예제에서는 Outlook.com 계정의 사용자 이름에 자리 표시자 값을 사용합니다.

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

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

예제 3: 지정된 SID가 있는 계정 가져오기

이 예제에서는 지정된 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

매개 변수

-Name

이 cmdlet이 가져오는 사용자 계정의 이름 배열을 지정합니다. 와일드카드 문자를 사용할 수 있습니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

Default
Position:0
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-SID

이 cmdlet이 가져오는 사용자 계정의 SID(보안 ID) 배열을 지정합니다.

매개 변수 속성

형식:

SecurityIdentifier[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SecurityIdentifier
Position:0
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

이 cmdlet에 문자열을 파이프할 수 있습니다.

SecurityIdentifier

SID를 이 cmdlet으로 파이프할 수 있습니다.

출력

System.Management.Automation.SecurityAccountsManager.LocalUser

이 cmdlet은 로컬 사용자 계정을 반환합니다.

참고

Windows PowerShell에는 다음과 같은 Get-LocalUser의 별칭이 포함되어 있습니다.

  • glu

LocalUser, LocalGroup및 LocalPrincipal 개체의 PrincipalSource 속성은 개체의 원본을 설명합니다. 가능한 원본은 다음과 같습니다.

  • 로컬
  • 액티브 디렉터리
  • Microsoft Entra 그룹
  • Microsoft 계정

PrincipalSource Windows 10, Windows Server 2016 이상 버전의 Windows 운영 체제에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.