Get-LocalUser

Модуль:
Microsoft.PowerShell.LocalAccounts Module

Возвращает учетные записи локальных пользователей.

Синтаксис

Default (По умолчанию) 

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

SecurityIdentifier 

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

Описание

Командлет Get-LocalUser получает локальные учетные записи пользователей. Этот командлет получает встроенные учетные записи пользователей по умолчанию, созданные локальные учетные записи пользователей и локальные учетные записи, подключенные к учетным записям Майкрософт.

Заметка

Модуль Microsoft.PowerShell.LocalAccounts недоступен в 32-разрядной версии PowerShell в 64-разрядной системе.

Примеры

Пример 1. Получение учетной записи с помощью имени

В этом примере возвращается учетная запись пользователя с именем AdminContoso02.

Get-LocalUser -Name "AdminContoso02"

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

Пример 2. Получение учетной записи, подключенной к учетной записи Майкрософт

В этом примере возвращается учетная запись пользователя, подключенная к учетной записи Майкрософт. В этом примере используется значение заполнителя для имени пользователя учетной записи в Outlook.com.

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

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

Пример 3. Получение учетной записи с указанным идентификатором безопасности

В этом примере возвращается локальная учетная запись пользователя с указанным идентификатором безопасности.

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

Задает массив имен учетных записей пользователей, которые получает этот командлет. Можно использовать подстановочный знак.

Свойства параметров

Тип:

String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

Default
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SID

Задает массив идентификаторов безопасности (SID) учетных записей пользователей, которые получает этот командлет.

Свойства параметров

Тип:

SecurityIdentifier[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SecurityIdentifier
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Вы можете передать строку в этот командлет.

SecurityIdentifier

Этот командлет можно передать идентификатор безопасности.

Выходные данные

System.Management.Automation.SecurityAccountsManager.LocalUser

Этот командлет возвращает локальные учетные записи пользователей.

Примечания

Windows PowerShell включает следующие псевдонимы для Get-LocalUser:

  • glu

Свойство PrincipalSource в LocalUser, LocalGroupи объекта LocalPrincipal описывает источник объекта. Возможные источники:

  • Местный
  • Active Directory
  • Группа Microsoft Entra
  • Учетная запись Майкрософт

PrincipalSource поддерживается только в Windows 10, Windows Server 2016 и более поздних версиях операционной системы Windows. Для более ранних версий свойство пусто.