Win32_UserAccount类

Win32_UserAccountWMI 类包含有关运行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类具有这些方法。

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

 

属性

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

用于属于此域的系统备份域控制器。

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64) 、 DisplayName (“Caption”)

帐户的域和用户名。

此属性继承自 CIM_ManagedSystemElement

说明

数据类型: 字符串

访问类型:只读

限定符: DisplayName (“Description”)

帐户的说明。

此属性继承自 CIM_ManagedSystemElement

已禁用

数据类型: 布尔值

访问类型:读/写

限定符: MappingStrings (“Win32API|网络管理结构|USER_INFO|UF_ACCOUNTDISABLE“)

Windows用户帐户处于禁用状态。

Domain

数据类型: 字符串

访问类型:只读

限定符: 重写 (“域”) ,MappingStrings (“Win32API|网络管理功能|domainname“)

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

FullName

数据类型: 字符串

访问类型:读/写

限定符:MappingStrings (“Win32API|网络管理结构|| USER_INFO_2usri2_full_name“)

本地用户的全名,例如:“Dan Wilson”。

InstallDate

数据类型: datetime

访问类型:只读

限定符: MappingStrings (“MIF。DMTF|ComponentID|001.5“) , DisplayName (”安装日期“)

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

此属性继承自 CIM_ManagedSystemElement

LocalAccount

数据类型: 布尔值

访问类型:只读

限定符: 已修复

如果 为 true,则在本地计算机上定义帐户。

此属性继承自 Win32_Account

锁定

数据类型: 布尔值

访问类型:读/写

限定符:MappingStrings (“Win32API|网络管理结构|| USER_INFO_2UF_LOCKOUT“)

如果为 true,则用户帐户被锁定在Windows操作系统中。

名称

数据类型: 字符串

访问类型:只读

限定符: 重写 (“名称”) , MappingStrings (“Win32API|网络管理结构|名称“)

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

示例:“danwilson”。

此属性继承自 CIM_ManagedSystemElement

PasswordChangeable

数据类型: 布尔值

访问类型:读/写

限定符:MappingStrings (“Win32API|网络管理结构|| USER_INFO_2UF_PASSWD_CANT_CHANGE“)

如果 为 true,则可以更改此用户帐户上的密码。

PasswordExpires

数据类型: 布尔值

访问类型:读/写

限定符:MappingStrings (“Win32API|网络管理结构|| USER_INFO_2UF_DONT_EXPIRE_PASSWD“)

如果 为 true,则此用户帐户的密码将过期。

PasswordRequired

数据类型: 布尔值

访问类型:读/写

限定符:MappingStrings (“Win32API|网络管理结构|| USER_INFO_2UF_PASSWD_NOTREQD“)

如果为 true,则Windows用户帐户上需要密码。 如果 为 false,则此帐户不需要密码。

SID

数据类型: 字符串

访问类型:只读

限定符:固定的 MappingStrings (“Win32API|安全标识符 (SID) “)

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

此属性继承自 Win32_Account

SIDType

数据类型: uint8

访问类型:只读

限定符:固定的 MappingStrings (“Win32API|访问控制枚举类型|SID_NAME_USE“)

指定 SID 类型的枚举值。

此属性继承自 Win32_Account

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Status

数据类型: 字符串

访问类型:只读

限定符: MaxLen (10) 、 DisplayName (“Status”)

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

此属性继承自 CIM_ManagedSystemElement

包括以下值:

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

压力 (“压力”)

NonRecover (“NonRecover ”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

注解

Win32_UserAccount类派生自Win32_Account

注意

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

 

示例

在 TechNet 库中使用 WMI VBScript 代码示例 列出本地用户帐户 使用 Win32_UserAccount 返回有关计算机上发现的本地用户帐户的信息。

将 SID 转换为用户帐户,将用户帐户转换为 SID TechNet 库中的 PowerShell 代码示例使用 Win32_UserAccount 将 SID 转换为用户帐户和/或用户帐户转换为 SID。

以下 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

操作系统类