класс Win32_UserAccount

Статья
12/06/2023

Класс WMI Win32_UserAccountсодержит сведения о учетной записи пользователя в компьютерной системе под управлением Windows.

Примечание.

Так как имя и домен являются ключевыми свойствами, перечисление Win32_UserAccount в большой сети может отрицательно повлиять на производительность. Вызов GetObject или запрос для конкретного экземпляра не влияет.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства и методы находятся в алфавитном порядке, а не в порядке MOF.

Синтаксис

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CC-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_UserAccount : Win32_Account
{
  uint32   AccountType;
  string   Caption;
  string   Description;
  boolean  Disabled;
  string   Domain;
  string   FullName;
  datetime InstallDate;
  boolean  LocalAccount;
  boolean  Lockout;
  string   Name;
  boolean  PasswordChangeable;
  boolean  PasswordExpires;
  boolean  PasswordRequired;
  string   SID;
  uint8    SIDType;
  string   Status;
};

Участники

Класс Win32_UserAccount имеет следующие типы элементов:

Методы
Свойства

Методы

Класс Win32_UserAccount имеет эти методы.

Метод	Description
Переименовать	Позволяет переименовать учетную запись пользователя.

Свойства

Класс Win32_UserAccount имеет эти свойства.

AccountType

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API|Структуры управления сетями|USER_INFO_2|usri2_flags")

Флаги, описывающие характеристики учетной записи пользователя Windows.

Временная повторяющаяся учетная запись (256)

UF_TEMP_DUPLICATE_ACCOUNT

Учетная запись локального пользователя для пользователей, имеющих основную учетную запись в другом домене. Эта учетная запись предоставляет пользователю доступ только к этому домену, а не к любому домену, которому доверяет этот домен.

Обычная учетная запись (512)

UF_NORMAL_ACCOUNT

Тип учетной записи по умолчанию, представляющий типичного пользователя.

Учетная запись доверия междомена (2048)

UF_INTERDOMAIN_TRUST_ACCOUNT

Учетная запись системного домена, который доверяет другим доменам.

Учетная запись доверия рабочей станции (4096)

UF_WORKSTATION_TRUST_ACCOUNT

Учетная запись компьютера для компьютерной системы под управлением Windows, являющейся членом этого домена.

Учетная запись доверия сервера (8192)

UF_SERVER_TRUST_ACCOUNT

Учетная запись контроллера домена резервного копирования системы, являющегося членом этого домена.

Заголовок

Тип данных: строка
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Домен и имя пользователя учетной записи.

Это свойство наследуется от CIM_ManagedSystemElement.

Description

Тип данных: строка
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Описание учетной записи.

Это свойство наследуется от CIM_ManagedSystemElement.

Отключен

Тип данных: логический
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API|Структуры управления сетями|USER_INFO|UF_ACCOUNTDISABLE")

Учетная запись пользователя Windows отключена.

Domain

Тип данных: строка
Тип доступа: только для чтения
Квалификаторы: Переопределение ("Домен"), MappingStrings ("Win32API|Функции управления сетями|доменное имя")

Имя домена Windows, к которому принадлежит учетная запись пользователя, например "NA-SALES".

FullName

Тип данных: строка
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API|Структуры управления сетями||USER_INFO_2 usri2_full_name")

Полное имя локального пользователя, например "Дэн Уилсон".

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF". DMTF |ComponentID|001.5"), DisplayName ("Дата установки")

Дата установки объекта. Это свойство не требует значения, указывающее, что объект установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

LocalAccount

Тип данных: логический
Тип доступа: только для чтения
Квалификаторы: исправлено

Если значение true, учетная запись определена на локальном компьютере.

Это свойство наследуется от Win32_Account.

Заблокировано

Тип данных: логический
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API|Структуры управления сетями||USER_INFO_2 UF_LOCKOUT")

Если значение true, учетная запись пользователя заблокирована из операционной системы Windows.

Имя

Тип данных: строка
Тип доступа: только для чтения
Квалификаторы: Переопределение ("Имя"), MappingStrings ("Win32API|Структуры управления сетями|name")

Имя учетной записи пользователя Windows в домене, указываемом свойством домена этого класса.

Пример: Danwilson.

Это свойство наследуется от CIM_ManagedSystemElement.

PasswordChangeable

Тип данных: логический
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API|Структуры управления сетями||USER_INFO_2 UF_PASSWD_CANT_CHANGE")

Если задано значение true, пароль этой учетной записи пользователя можно изменить.

PasswordExpires

Тип данных: логический
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API|Структуры управления сетями||USER_INFO_2 UF_DONT_EXPIRE_PASSWD")

Если задано значение true, срок действия пароля в этой учетной записи пользователя истекает.

PasswordRequired

Тип данных: логический
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API|Структуры управления сетями||USER_INFO_2 UF_PASSWD_NOTREQD")

Если задано значение true, пароль требуется в учетной записи пользователя Windows. Если значение false, эта учетная запись не требует пароля.

SID

Тип данных: строка
Тип доступа: только для чтения
Квалификаторы: Исправлено, СопоставлениеStrings ("Win32API|Идентификаторы безопасности (SID)")

Идентификатор безопасности (SID) для этой учетной записи. Идентификатор безопасности — это строковое значение переменной длины, используемой для идентификации доверенного лица. Каждая учетная запись имеет уникальный идентификатор безопасности, который является центром, например доменом Windows, проблемами. Идентификатор безопасности хранится в базе данных безопасности. Когда пользователь входит в систему, система получает идентификатор безопасности пользователя из базы данных, помещает идентификатор безопасности пользователя в маркер доступа пользователя, а затем использует идентификатор безопасности в маркере доступа пользователя для идентификации пользователя во всех последующих взаимодействиях с безопасностью Windows. Каждый идентификатор безопасности является уникальным идентификатором для пользователя или группы, а другой пользователь или группа не могут иметь один и тот же идентификатор безопасности.

Это свойство наследуется от Win32_Account.

SIDType

Тип данных: uint8
Тип доступа: только для чтения
Квалификаторы: Исправлено, СопоставлениеStrings ("Win32API|контроль доступа Типы перечисления|SID_NAME_USE")

Перечисленное значение, указывающее тип идентификатора безопасности.

Это свойство наследуется от Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Состояние

Тип данных: строка
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Текущее состояние объекта. Можно определить различные операционные и нерабоспособные состояния. К операционным состояниям относятся: "ОК", "Деградированный" и "Pred Fail", который является элементом, таким как диск с поддержкой SMART, который может работать правильно, но прогнозирует сбой в ближайшем будущем. Нерабочие состояния включают в себя: "Ошибка", "Запуск", "Остановка" и "Служба", которые могут применяться во время зеркало повторного изменения размера диска, перезагрузки списка разрешений пользователя или другой административной работы.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК ")

Ошибка ("Ошибка ")

Пониженный ("Пониженный ")

Неизвестно ("Неизвестно ")

Pred Fail ("Pred Fail ")

Запуск ("Запуск ")

Остановка ("остановка")

Service ("Service")

Подчеркнул ("подчеркнул ")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта ")

Lost Comm ("Lost Comm")

Замечания

Класс Win32_UserAccount является производным от Win32_Account.

Примечание.

Ошибка не возвращается для попытки записи в свойство только для чтения, а значение свойства остается неизменным.

Примеры

В следующем примере кода VBScript показано, как получить полное имя пользователя на локальном компьютере. Полное имя — это имя человеческого языка, например, имя пользователя "kensanchez", а полное имя может быть "Кен Санчес", поэтому вы замените реальное доменное имя и имя пользователя "MyDomainName" и "MyUserName". Для эффективного запроса необходимо указать свойства домена и имени пользователя.

Если вы являетесь администратором на удаленном компьютере, вы можете назначить имя удаленного компьютера для strComputer (вместо ".), а затем использовать следующий тип скрипта, чтобы получить полное имя учетной записи пользователя на локальном компьютере с удаленного компьютера.

On Error Resume Next
strComputer = "."

Set objUserAccount = GetObject("winmgmts{impersonationLevel=impersonate}!\\" & strComputer _
    & "\root\cimv2:Win32_UserAccount.Domain='MyDomainName',Name='MyUserName' ")

If Err = 0 Then
    WScript.Echo objUserAccount.FullName
Else
    WScript.Echo "No object found" & Err.Number
End If

using System.Management;

{
     ManagementScope mgmtScope = new ManagementScope("\\\\.\\Root\\CIMv2");
     ObjectQuery oQuery = new ObjectQuery("SELECT * FROM Win32_UserAccount Where Name=\"myUserName\"");
     ManagementObjectSearcher mgmtSearch = new ManagementObjectSearcher(mgmtScope, oQuery);
     ManagementObjectCollection objCollection = mgmtSearch.Get();
     foreach (ManagementObject mgmtObject in objCollection)
     {
          Console.WriteLine("Full Name : {0}", mgmtObject["FullName"]);
     }
}

Requirements

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL-библиотеки	CIMWin32.dll

См. также

Win32_Account
Классы операционной системы

Поделиться через

класс Win32_UserAccount

Синтаксис

Участники

Методы

Свойства

Замечания

Примеры

Requirements

См. также

Обратная связь

Дополнительные ресурсы