Win32_NetworkLoginProfile クラス
Win32_NetworkLoginProfileWMI クラスは、Windows を実行しているコンピューター システム上の特定のユーザーのネットワーク ログイン情報を表します。 これには、パスワードの状態、アクセス特権、ディスク クォータ、ログオン ディレクトリ パスが含まれますが、これらに限定されません。
次の構文はマネージド オブジェクト フォーマット (MOF) のコードを単純化したもので、すべての継承されたプロパティを含みます。
構文
[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{8502C4E7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkLoginProfile : CIM_Setting
{
string Caption;
string Description;
string SettingID;
datetime AccountExpires;
uint32 AuthorizationFlags;
uint32 BadPasswordCount;
uint32 CodePage;
string Comment;
uint32 CountryCode;
uint32 Flags;
string FullName;
string HomeDirectory;
string HomeDirectoryDrive;
datetime LastLogoff;
datetime LastLogon;
string LogonHours;
string LogonServer;
uint64 MaximumStorage;
string Name;
uint32 NumberOfLogons;
string Parameters;
datetime PasswordAge;
datetime PasswordExpires;
uint32 PrimaryGroupId;
uint32 Privileges;
string Profile;
string ScriptPath;
uint32 UnitsPerWeek;
string UserComment;
uint32 UserId;
string UserType;
string Workstations;
};
メンバー
Win32_NetworkLoginProfile クラスには、次の種類のメンバーがあります。
プロパティ
Win32_NetworkLoginProfile クラスには、これらのプロパティがあります。
-
AccountExpires
-
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_acct_expires")
アカウントの有効期限が切れます。 この値は、1970 年 1 月 1 日の 00:00:00 以降に経過した秒数から計算され、yyyymmddhhmmss.mmmmmm sutc という形式で設定されます。
例: 20521201000230.000000 000
-
-
AuthorizationFlags
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_auth_flags"), BitValues ("Printer", "Communication", "Server", "Accounts")
ユーザーが使用または変更を許可されているリソースを指定するフラグのセット。
-
-
1 (0x1)
-
[プリンター]
-
2 (0x2)
-
通信
-
4 (0x4)
-
サーバー
-
8 (0x8)
-
アカウント
BadPasswordCount
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理機能|NetUserEnum")
Windows を実行しているコンピューター システムにログオンするときに、ユーザーが不適切なパスワードを入力した回数。
例: 0
Caption
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (64)
現在のオブジェクトの短いテキスト説明。
このプロパティは、 CIM_Settingから継承されます。
CodePage
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_code_page")
ユーザーが選択した言語のコード ページ。 コード ページは、使用される文字セットです。
解説
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_comment")
このログオン プロファイルのコメントまたは説明。
CountryCode
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_country_code")
ユーザーが選択した言語の国/地域コード。
説明
-
データ型: string
-
アクセスの種類: 読み取り専用
現在のオブジェクトのテキスト説明。
このプロパティは、 CIM_Settingから継承されます。
Flags
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_flags")、 BitMap ("0"、"1"、"3"、"4"、"5"、"6"、"7"、"8"、"9"、"11"、"12"、"13"、"16"、"17"、"18"、"19"、 "20"、"21"、"22"、"23")、 BitValues ("Script"、"Account Disabled"、"Home Dir Required"、"Lockout"、"Password Not Required"、"Paswword Can't Change"、"Encrypted Test Password Allowed"、"Temp Duplicate Account"、"Normal Account"、"InterDomain Trust Account"、"WorkStation Trust Account"、"Server Trust Account"、 "Server Trust Account"、 "パスワードを期限切れにしない"、"MNS ログオン アカウント"、"スマートカードが必要"、"委任に対して信頼済み"、"委任されていない"、"DES キーのみを使用する"、"事前認証を必要としない"、"パスワードの期限切れ")
このネットワーク プロファイルで使用できるプロパティ。
設定できるプロパティは次のとおりです。
1 (0x1)
スクリプト
ログオン スクリプトが実行されました。 この値は LAN Manager 2.0 に設定する必要があります。
2 (0x2)
アカウントが無効
ユーザーのアカウントが無効になっています。
8 (0x8)
ホーム ディレクトリが必要です
ホーム ディレクトリが必要です。
16 (0x10)
ロックアウト
アカウントは現在ロックアウトされています。 NetUserSetInfo の場合、この値をクリアすると、以前にロックされたアカウントのロックを解除できます。 この値を使用して、以前にロック解除されたアカウントをロックすることはできません。
32 (0x20)
パスワードは不要
パスワードは必要ありません。
64 (0x40)
パスワードを変更できない
ユーザーはパスワードを変更できません。
128 (0x80)
暗号化されたテスト パスワードの許可
256 (0x100)
一時重複アカウント
プライマリ アカウントが別のドメインにあるユーザーのアカウント。 このアカウントは、このドメインへのユーザー アクセスを提供しますが、このドメインを信頼するドメインにはアクセスできません。 ユーザー マネージャーは、このアカウントの種類をローカル ユーザー アカウントと見なします。
512 (0x200)
標準アカウント
一般的なユーザーを表す既定のアカウントの種類。
2048 (0x800)
ドメイン間信頼アカウント
他のドメインを信頼するドメインの信頼アカウントに対する許可。
4096 (0x1000)
ワークステーション信頼アカウント
このドメインのメンバーである Windows ワークステーションまたはサーバーのコンピューター アカウント。
8192 (0x2000)
サーバー信頼アカウント
このドメインのメンバーであるバックアップ ドメイン コントローラーのコンピューター アカウント。
65536 (0x10000)
パスワードを期限切れにしない
131072 (0x20000)
MNS ログオン アカウント
MNS ユーザーを表すマジョリティ ノード セット (MNS) ログオン アカウントの種類。
262144 (0x40000)
スマートカードが必要
524288 (0x80000)
委任に対して信頼済み
1048576 (0x100000)
委任されていない
2097152 (0x200000)
DES キーのみを使用する
4194304 (0x400000)
事前認証を必要としない
8388608 (0x800000)
[パスワードの有効期限が切れました]
パスワードの有効期限が切れたことを示します。
次のプロパティでは、アカウントの種類について説明します。 設定できる値は 1 つだけです。
- UF_NORMAL_ACCOUNT
- UF_TEMP_DUPLICATE_ACCOUNT
- UF_WORKSTATION_TRUST_ACCOUNT
- UF_SERVER_TRUST_ACCOUNT
- UF_INTERDOMAIN_TRUST_ACCOUNT
FullName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_full_name")
ネットワーク ログイン プロファイルに属するユーザーのフル ネーム。 ユーザーが完全な名前をユーザー名に関連付けないことを選択した場合、この文字列は空にすることができます。
HomeDirectory
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_home_dir")
ユーザーのホーム ディレクトリへのパス。 ユーザーがホーム ディレクトリを指定しないことを選択した場合、この文字列は空になる可能性があります。
例:"\HOMEDIR"
HomeDirectoryDrive
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_home_dir_drive")
ログオン目的でユーザーのホーム ディレクトリに割り当てられたドライブ文字。
例: "C:"
LastLogoff
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_last_logoff")
ユーザーがシステムから最後にログオフしました。 この値は、1970 年 1 月 1 日の 00:00:00 以降に経過した秒数から計算されます。 "****************.**********+***" の値は、最後のログオフ時刻が不明であることを意味します。 この値の形式は yyyymmddhhmmss.mmmmmm sutc です。 このプロパティをローカル時刻に変換する方法については、「 WMI タスク: 日付と時刻」を参照してください。
例: 19521201000230.000000 000
LastLogon
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_last_logon")
ユーザーがシステムに最後にログオンしました。 この値は、1970 年 1 月 1 日の 00:00:00 以降に経過した秒数から計算されます。 この値の形式は yyyymmddhhmmss.mmmmmm sutc です。 このプロパティをローカル時刻に変換する方法については、「 WMI タスク: 日付と時刻」を参照してください。
例: 19521201000230.000000 000
LogonHours
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (147) 、MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_logon_hours")
ユーザーがログオンできる週の時間。 各ビットは、 UnitsPerWeek プロパティで指定された時間の単位を表します。 たとえば、時間の単位が時間単位の場合、最初のビット (ビット 0、単語 0) は日曜日、0:00 から 0:59、2 番目のビット (ビット 1、単語 0) は日曜日、1:00 から 1:59 などになります。 このメンバーが NULL に設定されている場合、時間制限はありません。 時刻は GMT に設定され、他のタイム ゾーン (たとえば、PST の場合は GMT から 8 時間を引いた場合) に合わせて調整する必要があります。
LogonServer
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_logon_server")
ログオン要求の送信先サーバーの名前。 サーバー名の前に 2 つの円記号 (\\) を付ける必要があります。 アスタリスク (\\*) のサーバー名は、ログオン要求が任意のログオン サーバーで処理できることを示します。 null 文字列は、要求がドメイン コントローラーに送信されることを示します。
例: "\\MyServer"
MaximumStorage
-
データ型: uint64
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_max_storage"), Units ("bytes")
ユーザーが使用できるディスク領域の最大容量。 MaximumStorage が USER_MAXSTORAGE_UNLIMITED に設定されている場合、ユーザーは使用可能なすべてのディスク領域を使用できます。
例: 10000000
スクリプトでの uint64 値の使用の詳細については、「 WMI でのスクリプト作成」を参照してください。
Name
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: key、 MaxLen (256)、 MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_name")
特定のドメインまたはコンピューター上のユーザー アカウント。 名前の文字数が UNLEN の値を超えることはできません。
例: "somedomain\johndoe"
NumberOfLogons
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_num_logons")
ユーザーがこのアカウントにログオンしようとした成功回数。 0xFFFFFFFFの値は、値が不明であることを示します。 このプロパティは、ドメイン内の各バックアップ ドメイン コントローラー (BDC) で個別に管理されます。 正確な値を取得するには、すべての BDC の最大値のみを使用する必要があります。
例: 4
パラメーター
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_parms")
アプリケーションで使用するために確保された領域。 この文字列は null にすることも、終端の null 文字の前に任意の数の文字を含めることもできます。 Microsoft 製品では、このメンバーを使用してユーザー構成情報を格納します。 この値はアプリケーションに固有であるため、この情報は変更しないでください。
PasswordAge
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_password_age")
パスワードが有効になった時間の長さ。 この値は、パスワードが最後に変更されてから経過した秒数から測定されます。
例: 00001201000230.000000 000
PasswordExpires
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_MODALS_INFO_0|usrmod0_max_passwd_age")
パスワードの有効期限が切れる日付と時刻。 値は次の形式で設定されます: yyyymmddhhmmss.mmmmmm sutc
例: 19521201000230.000000 000
PrimaryGroupId
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_primary_group_id")
このユーザーのプライマリ グローバル グループの相対識別子 (RID)。 識別子は、ユーザーのプロファイルが属するプライマリ グループを検証します。
特権
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_priv")
usri3_name プロパティに割り当てられた特権のレベル。
ゲスト (0)
ユーザー (1)
管理者 (2)
プロファイル
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_profile")
ユーザーのプロファイルへのパス。 この値には、null 文字列、ローカル絶対パス、または UNC パスを指定できます。 ユーザー プロファイルには、デスクトップの色など、ユーザーごとにカスタマイズ可能な設定が含まれています。
例: "C:\Windows"
ScriptPath
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_script_path")
ユーザーのログオン スクリプトへのディレクトリ パス。 ログオン スクリプトは、ユーザーがシステムにログオンするたびに一連のコマンドを自動的に実行します。
例: "C:\win\profiles\ThomasSteven"
SettingID
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (256)
現在のオブジェクトが認識される識別子。
このプロパティは、 CIM_Settingから継承されます。
UnitsPerWeek
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_units_per_week")
週が分割される時間単位の数。 これは、コンピューターへのユーザー アクセスを制限するために LogonHours プロパティと共に使用されます。
例: 168 (週あたりの時間数)
UserComment
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_usr_comment")
このプロファイルのユーザー定義のコメントまたは説明。
UserId
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_user_id")
ユーザーの RID。 識別子は、ユーザーが存在し、このドメインに固有であることを確認します。
UserType
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_flags")
ユーザーが特権を持つアカウントの種類。
値は次のとおりです。
- "通常のアカウント"
- "重複するアカウント"
- "ワークステーション信頼アカウント"
- "サーバー信頼アカウント"
- "ドメイン間信頼アカウント"
- "Unknown"
標準アカウント ("通常アカウント")
重複するアカウント ("重複するアカウント")
ワークステーション信頼アカウント ("ワークステーション信頼アカウント")
サーバー信頼アカウント ("サーバー信頼アカウント")
ドメイン間信頼アカウント ("ドメイン間信頼アカウント")
不明 ("不明")
ワークステーション
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|USER_INFO_3|usri3_workstations")
ユーザーがログオンできるワークステーションの名前。 最大 8 台のワークステーションを指定できます。名前はコンマ (,) で区切る必要があります。 null 文字列は制限がないことを示します。 すべてのワークステーションからこのアカウントへのログオンを無効にするには、このクラスの Flags プロパティにUF_ACCOUNTDISABLEを設定します。
注釈
Win32_NetworkLoginProfile クラスは、CIM_Settingから派生します。
このクラスを使用する呼び出し元プロセスには、レジストリが存在するコンピューターに対する SE_RESTORE_NAME 特権が必要です。 詳細については、「 特権操作の実行」を参照してください。
例
List Network Login Profiles PowerShell サンプルは、コンピューターのすべてのユーザーのネットワーク ログイン情報を返します。
次の VBScript サンプルでは、ネットワーク ログイン情報が返されます。
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colItems = objWMIService.ExecQuery _
("Select * from Win32_NetworkLoginProfile")
For Each objItem in colItems
dtmWMIDate = objItem.AccountExpires
strReturn = WMIDateStringToDate(dtmWMIDate)
Wscript.Echo "Account Expires: " & strReturn
Wscript.Echo "Authorization Flags: " & objItem.AuthorizationFlags
Wscript.Echo "Bad Password Count: " & objItem.BadPasswordCount
Wscript.Echo "Caption: " & objItem.Caption
Wscript.Echo "CodePage: " & objItem.CodePage
Wscript.Echo "Comment: " & objItem.Comment
Wscript.Echo "Country Code: " & objItem.CountryCode
Wscript.Echo "Description: " & objItem.Description
Wscript.Echo "Flags: " & objItem.Flags
Wscript.Echo "Full Name: " & objItem.FullName
Wscript.Echo "Home Directory: " & objItem.HomeDirectory
Wscript.Echo "Home Directory Drive: " & objItem.HomeDirectoryDrive
dtmWMIDate = objItem.LastLogoff
strReturn = WMIDateStringToDate(dtmWMIDate)
Wscript.Echo "Last Logoff: " & strReturn
dtmWMIDate = objItem.LastLogon
strReturn = WMIDateStringToDate(dtmWMIDate)
Wscript.Echo "Last Logon: " & strReturn
Wscript.Echo "Logon Hours: " & objItem.LogonHours
Wscript.Echo "Logon Server: " & objItem.LogonServer
Wscript.Echo "Maximum Storage: " & objItem.MaximumStorage
Wscript.Echo "Name: " & objItem.Name
Wscript.Echo "Number Of Logons: " & objItem.NumberOfLogons
Wscript.Echo "Password Age: " & objItem.PasswordAge
dtmWMIDate = objItem.PasswordExpires
strReturn = WMIDateStringToDate(dtmWMIDate)
Wscript.Echo "Password Expires: " & strReturn
Wscript.Echo "Primary Group ID: " & objItem.PrimaryGroupId
Wscript.Echo "Privileges: " & objItem.Privileges
Wscript.Echo "Profile: " & objItem.Profile
Wscript.Echo "Script Path: " & objItem.ScriptPath
Wscript.Echo "Setting ID: " & objItem.SettingID
Wscript.Echo "Units Per Week: " & objItem.UnitsPerWeek
Wscript.Echo "User Comment: " & objItem.UserComment
Wscript.Echo "User Id: " & objItem.UserId
Wscript.Echo "User Type: " & objItem.UserType
Wscript.Echo "Workstations: " & objItem.Workstations
Wscript.Echo
Next
Function WMIDateStringToDate(dtmWMIDate)
If Not IsNull(dtmWMIDate) Then
WMIDateStringToDate = CDate(Mid(dtmWMIDate, 5, 2) & "/" & _
Mid(dtmWMIDate, 7, 2) & "/" & Left(dtmWMIDate, 4) _
& " " & Mid (dtmWMIDate, 9, 2) & ":" & _
Mid(dtmWMIDate, 11, 2) & ":" & Mid(dtmWMIDate, 13, 2))
End If
End Function
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
名前空間 |
Root\CIMV2 |
MOF |
|
[DLL] |
|
こちらもご覧ください