Win32_UserAccount クラス
Win32_UserAccountWMI クラスには、Windows を実行しているコンピューター システム上のユーザー アカウントに関する情報が含まれています。
Note
名前とドメインは両方とも主要なプロパティであるため、大規模なネットワーク上で 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
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (64)、DisplayName ("Caption")
アカウントのドメインとユーザー名。
このプロパティは CIM_ManagedSystemElement から継承されます。
説明
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("説明")
アカウントの説明。
このプロパティは CIM_ManagedSystemElement から継承されます。
Disabled
-
データ型: boolean
-
アクセスの種類: 読み取り/書き込み
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造体|USER_INFO|UF_ACCOUNTDISABLE")
Windows ユーザー アカウントが無効になっています。
[ドメイン]
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: Override ("ドメイン")、MappingStrings ("Win32API|ネットワーク管理関数|domainname")
ユーザー アカウントが属する Windows ドメインの名前 (例: "NA-SALES")。
Fullname
-
データ型: string
-
アクセスの種類: 読み取り/書き込み
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造体|USER_INFO_2|usri2_full_name")
ローカル ユーザーのフル ネーム (例: "Dan Wilson")。
InstallDate
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5")、DisplayName ("Install Date")
オブジェクトがインストールされた日付。 このプロパティには、オブジェクトがインストールされていることを示す値は必要ありません。
このプロパティは CIM_ManagedSystemElement から継承されます。
LocalAccount
-
データ型: boolean
-
アクセスの種類: 読み取り専用
-
修飾子: Fixed
true の場合、アカウントはローカル コンピューター上で定義されています。
このプロパティは Win32_Account から継承されます。
"ロックアウト"
-
データ型: boolean
-
アクセスの種類: 読み取り/書き込み
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造体|USER_INFO_2|UF_LOCKOUT")
true の場合、ユーザー アカウントは Windows オペレーティング システムからロックアウトされます。
名前
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: Override ("名前")、MappingStrings ("Win32API|ネットワーク管理構造体|name")
このクラスの Domain プロパティで指定されるドメイン上の Windows ユーザー アカウントの名前。
例: "danwilson"。
このプロパティは CIM_ManagedSystemElement から継承されます。
PasswordChangeable
-
データ型: boolean
-
アクセスの種類: 読み取り/書き込み
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造体|USER_INFO_2|UF_PASSWD_CANT_CHANGE")
true の場合、このユーザー アカウントのパスワードを変更できます。
PasswordExpires
-
データ型: boolean
-
アクセスの種類: 読み取り/書き込み
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造体|USER_INFO_2|UF_DONT_EXPIRE_PASSWD")
true の場合、このユーザー アカウントのパスワードは期限切れになります。
PasswordRequired
-
データ型: boolean
-
アクセスの種類: 読み取り/書き込み
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造体|USER_INFO_2|UF_PASSWD_NOTREQD")
true の場合、Windows ユーザー アカウントにパスワードが必要です。 false の場合、このアカウントにはパスワードは必要ありません。
SID
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: Fixed、MappingStrings ("Win32API|セキュリティ識別子 (SID)")
このアカウントのセキュリティ識別子 (SID)。 SID は、トラスティを識別するために使用される可変長の文字列値です。 各アカウントには、Windows ドメインなどの機関が発行する一意の SID があります。 SID はセキュリティ データベースに格納されます。 ユーザーがログオンすると、システムはデータベースからユーザー SID を取得し、その SID をユーザー アクセス トークンに配置した後、以降の Windows セキュリティとのすべてのやり取りでユーザーを識別するためにユーザー アクセス トークン内の SID を使います。 各 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)
状態
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (10)、DisplayName ("Status")
オブジェクトの現在の状態。 さまざまな操作可能な状態と操作不可能な状態を定義できます。 動作の状態には、"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 から派生します。
Note
読み取り専用プロパティに書き込もうとしてもエラーは返されず、プロパティの値は変更されません。
例
次の 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"]);
}
}
要件
要件 | Value |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
名前空間 |
Root\CIMV2 |
MOF |
|
[DLL] |
|
関連項目