共用方式為

Win32_UserAccount 類別

  • 發行項

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

作業系統類別