Win32_UserAccount クラス

[アーティクル]
12/19/2023

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	CIMWin32.mof
[DLL]	CIMWin32.dll

次の方法で共有

Win32_UserAccount クラス

構文

メンバー

メソッド

プロパティ

解説

例

要件

関連項目

フィードバック

その他のリソース