Win32_UserAccount 類別

發行項
08/13/2024

Win32_UserAccount WMI 類別包含執行 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

屬於此網域成員的系統備份網域控制站帳戶。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen （64）， DisplayName （「Caption」）

帳戶的網域和使用者名稱。

此屬性繼承自 CIM_ManagedSystemElement 。

說明

資料類型：字串
存取類型：唯讀
限定詞： DisplayName （「Description」）

帳戶的描述。

此屬性繼承自 CIM_ManagedSystemElement 。

停用

資料類型： 布林值
存取類型：讀取/寫入
限定詞： MappingStrings （「Win32API|網路管理結構|USER_INFO|UF_ACCOUNTDISABLE「）

Windows 使用者帳戶已停用。

網域

資料類型：字串
存取類型：唯讀
限定詞：覆寫 （「網域」）， MappingStrings （「Win32API| 網路管理功能|domainname「）

使用者帳戶所屬的 Windows 網功能變數名稱稱，例如：「NA-SALES」。

FullName

資料類型：字串
存取類型：讀取/寫入
限定詞： MappingStrings （「Win32API|網路管理結構| USER_INFO_2 | usri2_full_name 「）

本機使用者的完整名稱，例如：「Dan Wilson」。

InstallDate

資料類型： datetime
存取類型：唯讀
限定詞： MappingStrings （「MIF.DMTF|ComponentID|001.5「）， DisplayName （」安裝日期「）

安裝物件的日期。這個屬性不需要值來指出物件已安裝。

此屬性繼承自 CIM_ManagedSystemElement 。

LocalAccount

資料類型： 布林值
存取類型：唯讀
限定詞：固定

如果 為 true ，則會在本機電腦上定義帳戶。

此屬性繼承自 Win32_Account 。

鎖定

資料類型： 布林值
存取類型：讀取/寫入
限定詞： MappingStrings （「Win32API|網路管理結構| | USER_INFO_2 UF_LOCKOUT 「）

如果 為 true ，使用者帳戶會鎖定在 Windows 作業系統外。

名稱

資料類型：字串
存取類型：唯讀
限定詞：覆寫 （「Name」）， MappingStrings （「Win32API| 網路管理結構|name「）

這個類別之 Domain 屬性所指定之網域 上的 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

資料類型：字串
存取類型：唯讀
限定詞： Fixed 、 MappingStrings （「Win32API|安全性識別碼（SID）「）

此帳戶的安全性識別碼（SID）。 SID 是可變長度的字串值，用來識別信任項。每個帳戶都有授權單位（例如 Windows 網域）問題的唯一 SID。 SID 會儲存在安全性資料庫中。當使用者登入時，系統會從資料庫擷取使用者 SID、將 SID 放在使用者存取權杖中，然後使用使用者存取權杖中的 SID 來識別使用者與 Windows 安全性的所有後續互動。每個 SID 都是使用者或群組的唯一識別碼，而不同的使用者或群組不能有相同的 SID。

此屬性繼承自 Win32_Account 。

SIDType

資料類型： uint8
存取類型：唯讀
限定詞： Fixed 、 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）

狀態

數據類型：字串
存取類型：唯讀
限定符： MaxLen （10）， DisplayName （“Status”）

物件的目前狀態。您可以定義各種操作和非操作狀態。作業狀態包括：「OK」、「已降級」和「Pred Fail」，這是一個元素，例如可能正常運作的 SMART 硬碟，但預測近期發生失敗。非操作狀態包括：「錯誤」、「啟動」、「停止」和「服務」，可在磁碟鏡像重新壓縮期間套用、重載用戶權力清單或其他系統管理工作。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定（“OK”）

錯誤（「錯誤」

已降級 （「已降級」

未知（“未知”）

Pred Fail （“Pred Fail”）

啟動（“開始”）

停止（“停止”）

服務（“Service”）

壓力（“壓力”）

NonRecover （“NonRecover”）

無連絡人 （“無聯繫人”）

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
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

Win32_Account
作業系統類別

共用方式為

Win32_UserAccount 類別

語法

成員

方法

屬性

備註

範例

需求

另請參閱

意見反應

其他資源