Win32_UserAccount 类

项目
12/13/2023

Win32_UserAccountWMI 类包含有关运行 Windows 的计算机系统上的用户帐户的信息。

注意

由于 Name 和 Domain 都是关键属性，因此枚举大型网络上的 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 类具有以下方法。

方法	说明
重命名	允许重命名用户帐户。

属性

Win32_UserAccount 类具有以下属性。

AccountType

数据类型：uint32
访问类型：只读
限定符：MappingStrings ("Win32API|Network Management Structures|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

作为此域的成员的系统备份域控制器的帐户。

Caption

数据类型： 字符串
访问类型：只读
限定符：MaxLen (64)、DisplayName（“描述文字”）

帐户的域和用户名。

此属性继承自 CIM_ManagedSystemElement。

描述

数据类型：字符串
访问类型：只读
限定符：DisplayName ("Description")

帐户的说明。

此属性继承自 CIM_ManagedSystemElement。

已禁用

数据类型：boolean
访问类型：读/写
限定符：MappingStrings ("Win32API|Network Management Structures|USER_INFO|UF_ACCOUNTDISABLE")

Windows 用户帐户已禁用。

Domain

数据类型： 字符串
访问类型：只读
限定符：Override ("Domain")、MappingStrings ("Win32API|Network Management Functions|domainname")

用户帐户所属的 Windows 域的名称，例如：“NA-SALES”。

FullName

数据类型： 字符串
访问类型：读/写
限定符：MappingStrings ("Win32API|Network Management Structures|USER_INFO_2|usri2_full_name")

本地用户的全名，例如：“Dan Wilson”。

InstallDate

数据类型：datetime
访问类型：只读
限定符：MappingStrings（“MIF.DMTF|ComponentID|001.5”）、DisplayName（“安装日期”）

对象的安装日期。此属性不需要值来指示对象已安装。

此属性继承自 CIM_ManagedSystemElement。

LocalAccount

数据类型：boolean
访问类型：只读
限定符：Fixed

如果该值为 true，则帐户是在本地计算机上定义的。

此属性继承自 Win32_Account。

Lockout

数据类型： 布尔值
访问类型：读/写
限定符：MappingStrings ("Win32API|Network Management Structures|USER_INFO_2|UF_LOCKOUT")

如果该值为 true，则用户帐户被锁定在 Windows 操作系统之外。

Name

数据类型：字符串
访问类型：只读
限定符：Override ("Name")、MappingStrings ("Win32API|Network Management Structures|name")

此类的 Domain 属性指定的域中的 Windows 用户帐户的名称。

示例：“danwilson”。

此属性继承自 CIM_ManagedSystemElement。

PasswordChangeable

数据类型：boolean
访问类型：读/写
限定符：MappingStrings ("Win32API|Network Management Structures|USER_INFO_2|UF_PASSWD_CANT_CHANGE")

如果该值为 true，则可以更改此用户帐户的密码。

PasswordExpires

数据类型： 布尔值
访问类型：读/写
限定符：MappingStrings ("Win32API|Network Management Structures|USER_INFO_2|UF_DONT_EXPIRE_PASSWD")

如果该值为 true，则此用户帐户的密码过期。

PasswordRequired

数据类型： 布尔值
访问类型：读/写
限定符：MappingStrings ("Win32API|Network Management Structures|USER_INFO_2|UF_PASSWD_NOTREQD")

如果该值为 true，则 Windows 用户帐户需要密码。如果该值为 false，则此帐户不需要密码。

SID

数据类型：字符串
访问类型：只读
限定符：Fixed、MappingStrings ("Win32API|Security Identifiers (SIDs)")

此帐户的安全标识符 (SID)。 SID 是长度可变的字符串值，用于标识受信者。每个帐户都有一个由颁发机构（例如 Windows 域）颁发的唯一 SID。 SID 存储在安全数据库中。当用户登录时，系统会从数据库中检索用户 SID，将此 SID 置于用户访问令牌中，然后使用用户访问令牌中的 SID 在与 Windows 安全的所有后续交互中标识该用户。每个 SID 都是用户或组的唯一标识符，不同的用户或组不能具有相同的 SID。

此属性继承自 Win32_Account。

SIDType

数据类型：uint8
访问类型：只读
限定符：Fixed、MappingStrings ("Win32API|Access Control Enumeration Types|SID_NAME_USE")

一个枚举值，用于指定 SID 的类型。

此属性继承自 Win32_Account。

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

状态

数据类型：字符串
访问类型：只读
限定符：MaxLen (10)、DisplayName（“状态”）

对象的当前状态。可以定义各种操作和非操作状态。操作状态包括：“OK”、“Degraded”和“Pred Fail”（一个元素，例如一个启用 SMART 的硬盘驱动器，它可能正在正常运行，但预测近期会发生故障）。非操作状态包括：“Error”、“Starting”、“Stopping”和“Service”，这些状态可在重新生成磁盘镜像、重新加载用户权限列表或其他管理工作期间应用。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK（“OK”）

Error（“Error”）

Degraded（“Degraded”）

Unknown（“"Unknown”）

Pred Fail（“Pred Fail”）

Starting（“Starting”）

Stopping（“Stopping”）

Service（“Service”）

Stressed（“Stressed”）

NonRecover（“NonRecover”）

No Contact（“No Contact”）

Lost Comm（“Lost Comm”）

备注

Win32_UserAccount 类派生自 Win32_Account。

注意

尝试写入只读属性时不会返回错误，并且该属性的值保持不变。

示例

以下 VBScript 代码示例演示如何获取本地计算机上的用户的全名。全名是人类语言名称，例如，某个人可能有用户名“kensanchez”，全名可能是“Ken Sanchez”，因此，请将真实的域名和用户名替换为“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"]);
     }
}

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

Win32_Account
操作系统类

通过

Win32_UserAccount 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

其他资源