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

アクセスの種類: 読み取り専用

修飾子: FixedMappingStrings ("Win32API|セキュリティ識別子 (SID)")

このアカウントのセキュリティ識別子 (SID)。 SID は、トラスティを識別するために使用される可変長の文字列値です。 各アカウントには、Windows ドメインなどの機関が発行する一意の SID があります。 SID はセキュリティ データベースに格納されます。 ユーザーがログオンすると、システムはデータベースからユーザー SID を取得し、その SID をユーザー アクセス トークンに配置した後、以降の Windows セキュリティとのすべてのやり取りでユーザーを識別するためにユーザー アクセス トークン内の SID を使います。 各 SID はユーザーやグループの一意識別子であり、異なるユーザーやグループが同じ SID を持つことはできません。

このプロパティは Win32_Account から継承されます。

SIDType

データ型: uint8

アクセスの種類: 読み取り専用

修飾子: FixedMappingStrings ("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
CIMWin32.mof
[DLL]
CIMWin32.dll

関連項目

Win32_Account

オペレーティング システム クラス