Win32_WMISetting クラス

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

Win32_WMISetting シングルトン WMI クラスには、WMI サービスの操作パラメーターが含まれています。このクラスは、各 Windows システムに対して常に存在し、削除できないインスタンスを 1 つだけ持つことができます。追加のインスタンスを作成できません。

次の構文は、マネージドオブジェクトフォーマット (MOF) コードを簡素化しており、継承されたすべてのプロパティを含んでいます。プロパティとメソッドは、MOF の順序ではなく、アルファベット順です。

構文

[Singleton, Dynamic, Provider("WBEMCORE"), UUID("{A83EF166-CA8D-11d2-B33D-00104BCC4B4A}"), AMENDMENT]
class Win32_WMISetting : CIM_Setting
{
  string   Caption;
  string   Description;
  string   SettingID;
  string   ASPScriptDefaultNamespace = "\\\\root\\cimv2";
  boolean  ASPScriptEnabled;
  string   AutorecoverMofs[];
  uint32   AutoStartWin9X;
  uint32   BackupInterval;
  datetime BackupLastTime;
  string   BuildVersion;
  string   DatabaseDirectory;
  uint32   DatabaseMaxSize;
  boolean  EnableAnonWin9xConnections;
  boolean  EnableEvents;
  boolean  EnableStartupHeapPreallocation;
  uint32   HighThresholdOnClientObjects;
  uint32   HighThresholdOnEvents;
  string   InstallationDirectory;
  uint32   LastStartupHeapPreallocation;
  string   LoggingDirectory;
  uint32   LoggingLevel;
  uint32   LowThresholdOnClientObjects;
  uint32   LowThresholdOnEvents;
  uint32   MaxLogFileSize;
  uint32   MaxWaitOnClientObjects;
  uint32   MaxWaitOnEvents;
  string   MofSelfInstallDirectory;
};

メンバー

Win32_WMISetting クラスには、次の種類のメンバーがあります。

Properties

プロパティ

Win32_WMISetting クラスには、これらのプロパティがあります。

ASPScriptDefaultNamespace

データ型: string
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|既定の名前空間")

既定のスクリプト名前空間。このプロパティには、呼び出し元によって何も指定されていない場合に、WMI 用スクリプト API からの呼び出しによって使用される名前空間が含まれます。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\Wbem\ scripting|既定の名前空間

例: root\cimv2

このプロパティを使用するスクリプトの例については、「解説」セクションを参照してください。

ASPScriptEnabled

データ型: boolean
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|ASP に対して有効にする")

True の場合、WMI スクリプトは Active Server Pages (ASP) で使用できます。このプロパティは、サポートされていないバージョンの Windows を実行しているシステムでのみ有効です。サポートされている Windows システムの場合、WMI スクリプトは常に ASP で許可されます。

AutorecoverMofs

データ型: 文字列 配列
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Autorecover MOFs")

WMI リポジトリの初期化または回復に使用される完全修飾 MOF ファイル名の一覧。一覧は、MOF ファイルをコンパイルする順序を決定します。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\Wbem\ CIMOM|MOF の自動回復

AutoStartWin9X

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|AutostartWin9X")

サポートされていません。

開始しない (0)

自動開始 (1)

再起動時に開始する (2)

BackupInterval

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|バックアップ間隔のしきい値")、単位 ("分")

サポートされていません。代わりに、WMI リポジトリを手動でバックアップします。

BackupLastTime

データ型: datetime
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32API|時間関数|GetTimeZoneInformation")

最後のバックアップが実行された日時。

BuildVersion

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|ビルド")

現在インストールされている WMI サービスのバージョン情報。

WMI データベースのバックアップの間に経過する時間の長さ。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|ビルド

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)

現在のオブジェクトの短いテキスト説明。

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

DatabaseDirectory

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|リポジトリディレクトリ")

WMI リポジトリを含むディレクトリパス。

DatabaseMaxSize

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|最大 DB サイズ"、単位 ("キロバイト")

WMI リポジトリの最大サイズ。

説明

データ型: string
アクセスの種類: 読み取り専用

現在のオブジェクトのテキスト説明。

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

EnableAnonWin9xConnections

データ型: boolean
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableAnonConnections")

サポートされていません。

EnableEvents

データ型: boolean
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableEvents")

True の場合、WMI イベントサブシステムを有効にする必要があります。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|CIMOM|EnableEvents

EnableStartupHeapPreallocation

データ型: boolean
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableStartupHeapPreallocation")

True の場合、WMI は、WMI の初期化時に LastStartupHeapPreallocation 値のサイズを持つ事前に割り当てられたヒープを作成します。

HighThresholdOnClientObjects

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|クライアントオブジェクトの高しきい値"、単位 ("1 秒あたりのオブジェクト数")

プロバイダーが作成したオブジェクトをクライアントに配信できる最大レート。プロバイダーとクライアント間の速度の差に対応するために、WMI はオブジェクトをコンシューマーに配信する前にキューに保持します。効率を高めるには、コンシューマーはプロバイダーに一致するペースでオブジェクトを収集する必要があります。収集されていないオブジェクトによって保持されているメモリが LowThresholdOnObjects に達すると、WMI によってキューへの新しいオブジェクトの追加が遅くなります。収集されていないイベントが蓄積され続け、使用されるメモリが HighThresholdOnClientObjects の値である間に MaxWaitOnClientObjects でイベントを配信するための最大待機に達した場合、WMI はプロバイダーからそれ以上のオブジェクトを受け入れず、クライアントにWBEM_E_OUT_OF_MEMORYを返します。

HighThresholdOnEvents

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|イベントのしきい値が高い"、単位 ("1 秒あたりのイベント数")

クライアントにイベントを配信する最大レート。プロバイダーとクライアント間の速度差に対応するために、WMI はイベントをコンシューマーに配信する前にキューに入れます。効率を高めるには、コンシューマーはプロバイダーに一致するペースでイベントを収集する必要があります。収集されていないイベントによって保持されているメモリが LowThresholdOnObjects に達すると、WMI によってキューへの新しいイベントの追加が遅くなります。収集されていないイベントが蓄積され続け、使用されるメモリが HighThresholdOnEvents の値である間に MaxWaitOnEvents でイベントを配信するための最大待機に達した場合、WMI はプロバイダーからそれ以上のイベントを受け入れず、クライアントにWBEM_E_OUT_OF_MEMORYを返します。

注意

調整は永続的なイベントコンシューマーに対してのみ実行されるため、一時的なコンシューマーは、WMI 内部イベントキューにイベントがバックアップされるときに調整を想定しないでください。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\Wbem\ CIMOM|クライアントオブジェクトの高しきい値 (B)

InstallationDirectory

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|インストールディレクトリ")

WMI ソフトウェアがインストールされているディレクトリパス。既定の場所は \System32\Wbem です。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|インストールディレクトリ

LastStartupHeapPreallocation

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|LastStartupHeapPreallocation"), Units ("bytes")

初期化中に WMI によって作成された事前に割り当てられたヒープのサイズ。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|CIMOM|LastStartupHeapPreallocation

LoggingDirectory

データ型: string
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|ログディレクトリ")

WMI システムログファイルの場所を含むディレクトリパス。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|CIMOM|ログディレクトリ

LoggingLevel

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|ログ記録")

イベントログの有効化と、使用されるログ記録の詳細レベル。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|CIMOM|ログ

Off (0)

エラーログ (1)

詳細エラーログ (2)

LowThresholdOnClientObjects

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|クライアントオブジェクトのしきい値が低い"、単位 ("1 秒あたりのオブジェクト数")

WMI がクライアント用に作成された新しいオブジェクトの作成を遅くし始める速度。プロバイダーとクライアント間の速度の差に対応するために、WMI はオブジェクトをコンシューマーに配信する前にキューに保持します。効率を高めるには、コンシューマーはプロバイダーに一致するペースでオブジェクトを収集する必要があります。オブジェクトに対する要求の速度が LowThresholdOnClientObjects に達した場合、WMI はクライアントの使用率に合わせて新しいオブジェクトの作成を徐々に遅くします。この速度低下は、オブジェクトが作成される速度がこのプロパティの値を超えると開始されます。 「HighThresholdOnClientObjects」を参照してください。

このプロパティには、レジストリ値が反映されます。

\ KEY_LOCAL_MACHINEソフトウェア\マイクロソフト\Wbem\ CIMOM|クライアントオブジェクトの高しきい値 (B)

LowThresholdOnEvents

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Low Threshold On Events"), Units ("events per second")

WMI が新しいイベントの配信を遅らせ始める速度。プロバイダーとクライアント間の速度差に対応するために、WMI はイベントをコンシューマーに配信する前にキューに入れます。効率を高めるには、コンシューマーはプロバイダーに一致するペースでオブジェクトを収集する必要があります。キューが制御不能になっていくと、WMI スロットルが遅くなり、クライアントレートに合わせてイベントの配信が徐々に遅くなります。この速度低下は、イベントが生成される速度がこのプロパティの値を超えると開始されます。 「HighThresholdOnEvents」を参照してください。

注意

このプロパティには、レジストリ値が反映されます。

Hkey_local_machine\ソフトウェア\マイクロソフト\Wbem\ CIMOM|クライアントオブジェクト {B} の高しきい値

MaxLogFileSize

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|ログファイルの最大サイズ"、単位 ("bytes")

WMI サービスによって生成されるログファイルの最大サイズ。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|CIMOM|ログファイルの最大サイズ

MaxWaitOnClientObjects

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Max Wait On Events"), Units ("ミリ秒")

新しく作成されたオブジェクトが破棄されてエラー値が返されるまで、クライアントによって使用されるのを待機する時間。このプロパティは 、LowThresholdOnClientObjects プロパティと HighThresholdOnClientObjects プロパティとやり取りして調整を行い、コンシューマーがオブジェクトを受け取る速度が遅すぎるときにコンシューマーにオブジェクトを配信します。

MaxWaitOnEvents

データ型: uint32
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Max Wait On Events"), Units ("milliseconds")

クライアントに送信されたイベントが破棄されるまでにキューに入れる時間。このプロパティは 、LowThresholdOnEvents および HighThresholdOnEvents と対話して、コンシューマーがオブジェクトを受信する速度が遅すぎるときにコンシューマーへのオブジェクトの配信を調整 (遅く) します。

このプロパティには、レジストリ値が反映されます。

Hkey_local_machine\ソフトウェア\マイクロソフト\Wbem\ CIMOM|最大待機イベント数 (ミリ秒)

MofSelfInstallDirectory

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|MOF Self-Install ディレクトリ")

WMI リポジトリに MOF ファイルをインストールするアプリケーションのディレクトリパス。 WMI は、このディレクトリに配置されたすべての MOF ファイルを自動的にコンパイルし、その成功に応じて、MOF を good または bad というラベルの付いたサブディレクトリに移動します。 # pragma autorecover コマンドが含まれている場合、WMI がリポジトリを初期化または回復するときに使用される AutorecoverMofs リストに完全修飾ファイル名が追加されます。一覧は、MOF のコンパイル順序を決定します。

このプロパティは、レジストリキーの値を反映します。

Hkey_local_machine\ソフトウェア\マイクロソフト\WBEM|CIMOM|MOF Self=Install Directory

SettingID

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (256)

現在のオブジェクトが認識される識別子。

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

注釈

Win32_WMISetting クラスは、CIM_Settingから派生します。このクラスのインスタンスは 1 台のコンピューターに 1 つだけ存在できます。

スクリプトのデバッグや WMI サービス自体に関する問題のトラブルシューティングを行う場合は、コンピューター上で WMI がどのように構成されているかを知ることは非常に役立ちます。たとえば、多くの WMI スクリプトは、root\cimv2 がターゲットコンピューターの既定の名前空間であるという前提で記述されています。その結果、"Root\CIMv2" のクラスにアクセスする必要があるスクリプトライターは、次のコードサンプルに示すように、GetObject モニカーに名前空間を含めないことが多くなります。

Set colServices = GetObject("winmgmts:").ExecQuery ("SELECT * FROM Win32_Service")

root\cimv2 がターゲットコンピューターの既定の名前空間でない場合、このスクリプトは失敗します。これが発生しないようにするには、次のコードサンプルに示すように、名前空間 root\cimv2 をモニカーに含める必要があります。

Set colServices = GetObject("winmgmts:root\cimv2").ExecQuery("SELECT * FROM Win32_Service")

ターゲットコンピューター上の既定の名前空間がスクリプトで想定されている名前空間と異なる場合、スクリプトは失敗します。その上、ユーザーにはやや誤解を招くエラーメッセージ "無効なクラス" が表示されます。実際、エラーは、クラスが無効であるためではなく、クラスが既定の名前空間で見つからないためです。これは、指定された名前空間に関する問題 (または、この場合は指定されなかった) ではなく、クラスで発生する可能性のある問題を調査する可能性があるため、トラブルシューティングが困難な問題です。

Win32_WMISetting クラスを使用して、WMI がコンピューターでどのように構成されているかを確認できます。既定の名前空間や WMI ビルド番号などの構成の詳細は、スクリプトの問題のトラブルシューティングに役立ちます。また、これらの設定では、WMI エラーがコンピューターに記録される方法や、WMI リポジトリを再構築する必要がある場合に自動的に再読み込みされる WMI プロバイダーなど、重要な管理情報も提供されます。

例

TechNet ギャラリーの WMI 設定の変更 VBScript コード例では、 Win32_WMISetting クラスを使用して WMI バックアップ間隔とログレベルを構成します。

TechNet ギャラリーの既定の名前空間 VBScript の一覧表示コード例では、 Win32_WMISetting クラスを使用して、現在の WMI の "スクリプトの既定の名前空間" 設定を取得して表示します。

TechNet ギャラリーの [既定の WMI 名前空間の変更 ] VBScript コード例では、 ASPScriptDefaultNamespace プロパティを使用して、WMI の "スクリプトの既定の名前空間" 設定を "root\cimv2" に設定します。

すべての WMI 設定の一覧表示 VBSCript コード例では、Win32_WMISettingのプロパティの数を使用して、コンピューターで構成された WMI 設定の一覧を返します。

[WMI 設定情報の一覧表示] JavaScript コード例では、Win32_WMISettingのプロパティの数を使用して、コンピューターで構成されている WMI 設定の一覧を返します。

リスト WMI 設定情報 Python のコード例では、Win32_WMISettingのプロパティの数を使用して、コンピューターで構成されている WMI 設定の一覧を返します。

LIST WMI Setting Information Object REXX コード例では、Win32_WMISettingのプロパティの数を使用して、コンピューターで構成されている WMI 設定の一覧を返します。

次の VBScript コード例は、ローカルコンピューターで実行されている WMI のバージョンを取得する方法を示しています。 "Win32_WMISetting=@" は、クラスの単一インスタンスを示します。詳細については、「WMI のバージョン」を参照してください。

set objWMIService = GetObject("winmgmts:{impersonationLevel=Impersonate}!/Root/CIMv2")

set objWMISetting = objWMIService.Get("Win32_WMISetting=@")

WScript.Echo  objWMISetting.BuildVersion

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	Wbemcore.dll

こちらもご覧ください

CIM_Setting
WMI サービス管理クラス

Win32_WMISetting クラス

構文

メンバー

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース