Win32_WMISetting 類別

發行項
11/10/2023

Win32_WMISetting單一 WMI 類別包含 WMI 服務的作業參數。這個類別只能有一個實例，每個 Windows 系統一律存在且無法刪除。無法建立其他實例。

下列語法是從 Managed 物件格式（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類別具有下列類型的成員：

屬性

屬性

Win32_WMISetting 類別具有這些屬性。

ASPScriptDefaultNamespace

數據類型：字串
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\scripting|預設命名空間“）

預設文本命名空間。如果呼叫端未指定任何專案，這個屬性會包含來自 WMI 腳本 API 的呼叫所使用的命名空間。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM\ 腳本|預設命名空間

範例：root\cimv2

如需使用此屬性的範例腳本，請參閱一節。

ASPScriptEnabled

數據類型： 布爾值
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\scripting|開啟 ASP”

如果 為 True，可以在 Active Server Pages （ASP）上使用 WMI 腳本。此屬性僅在執行不支援的 Windows 版本系統上有效。針對支援的 Windows 系統，ASP 一律允許 WMI 腳本。

AutorecoverMofs

數據類型：字串陣列
存取類型：唯讀
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|自動回覆MOF

用來初始化或復原 WMI 存放庫的完整 MOF 檔案名清單。此清單會決定MOF檔案的編譯順序。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\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

數據類型：字串
存取類型：唯讀
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM|Build“）

目前安裝的 WMI 服務版本資訊。

WMI 資料庫備份之間經過的時間長度。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM|建立

標題

數據類型：字串
存取類型：唯讀
限定符： MaxLen （64）

目前對象的簡短文字描述。

此屬性繼承自 CIM_Setting。

DatabaseDirectory

數據類型：字串
存取類型：唯讀
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|存放庫目錄“）

包含 WMI 存放庫的目錄路徑。

DatabaseMaxSize

數據類型： uint32
存取類型：唯讀
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|資料庫大小上限）、單位（「KB」）

WMI 存放庫的大小上限。

說明

數據類型：字串
存取類型：唯讀

目前物件的文字描述。

此屬性繼承自 CIM_Setting。

EnableAnonWin9x 連線 ions

數據類型： 布爾值
存取類型：讀取/寫入
限定符：MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableAnon 連線 ions“）

不支援。

EnableEvents

數據類型： 布爾值
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableEvents“）

如果 為 True，則應該啟用 WMI 事件子系統。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM|CIMOM|EnableEvents

EnableStartupHeapPreallocation

數據類型： 布爾值
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableStartupHeapPreallocation“）

如果為 True，WMI 會在初始化 WMI 時，使用 LastStartupHeapPreallocation 值的大小建立預先配置的堆積。

HighThresholdOnClientObjects

數據類型： uint32
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|用戶端物件的高臨界值）、單位（「每秒物件數」）

提供者建立物件可傳遞至用戶端的速率上限。為了因應提供者和客戶端之間的速度差異，WMI 會在將對象傳遞給取用者之前，先將物件放在佇列中。為了提高效率，取用者必須以符合提供者的步調收集物件。如果未擷取物件所持有的記憶體達到 LowThresholdOnObjects，則WMI會減緩將新物件新增至佇列的速度。如果未擷取的事件繼續累積，且達到在 MaxWaitOnClientObjects 中傳遞事件的最大等候時間，而使用的記憶體位於 HighThresholdOnClientObjects 中的值，則 WMI 不會再接受來自提供者的物件，並將WBEM_E_OUT_OF_MEMORY傳回給用戶端。

HighThresholdOnEvents

數據類型： uint32
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|事件的高臨界值）、單位（「每秒事件數」）

事件要傳遞至用戶端的速率上限。為了因應提供者和客戶端之間的速度差異，WMI 會在將事件傳遞給取用者之前先排入佇列。為了提高效率，取用者必須以符合提供者的步調收集事件。如果未收集的事件所持有的記憶體達到 LowThresholdOnObjects，則 WMI 會減緩將新事件新增至佇列的速度。如果未擷取的事件繼續累積，且達到 MaxWaitOnEvents 中傳遞事件的最大等候時間，而使用的記憶體位於 HighThresholdOnEvents 中的值，則 WMI 不會接受來自提供者的更多事件，並將WBEM_E_OUT_OF_MEMORY傳回給用戶端。

注意

節流只會針對永久事件取用者執行，因此暫時取用者不應該預期在WMI內部事件佇列中備份事件時進行節流。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM CIMOM|\ 用戶端物件的高臨界值（B）

InstallationDirectory

數據類型：字串
存取類型：唯讀
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM|安裝目錄“）

已安裝 WMI 軟體的目錄路徑。默認位置為 \System32\Wbem。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM|安裝目錄

LastStartupHeapPreallocation

數據類型： uint32
存取類型：唯讀
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|LastStartupHeapPreallocation“）， Units （”bytes“）

初始化期間 WMI 所建立之預先配置的堆積大小。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM|CIMOM|LastStartupHeapPreallocation

LoggingDirectory

數據類型：字串
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|記錄目錄“）

包含 WMI 系統記錄檔位置的目錄路徑。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM|CIMOM|記錄目錄

LoggingLevel

數據類型： uint32
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|記錄“）

啟用事件記錄和使用的詳細記錄層級。

這個屬性會反映登錄機碼中的值。

\HKEY_LOCAL_MACHINE軟體\Microsoft\WBEM|CIMOM|測井

關閉（0）

錯誤記錄 （1）

詳細資訊錯誤記錄 （2）

LowThresholdOnClientObjects

數據類型： uint32
存取類型：讀取/寫入
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|客戶端物件的低臨界值）、單位（「每秒物件數」）

WMI 開始減緩為用戶端建立之新物件的建立速度。為了因應提供者和客戶端之間的速度差異，WMI 會在將對象傳遞給取用者之前，先將物件放在佇列中。為了提高效率，取用者必須以符合提供者的步調收集物件。如果物件的要求速率達到 LowThresholdOnClientObjects，則 WMI 會逐漸減緩新物件的建立速度，以符合用戶端的使用速率。當建立物件的速率超過這個屬性的值時，就會開始此速度變慢。請參閱 HighThresholdOnClientObjects。

這個屬性會反映登錄值。

\ KEY_LOCAL_MACHINE Software \ Microsoft \ WBEM CIMOM| \ 用戶端物件的高臨界值（B）

LowThresholdOnEvents

資料類型： uint32
存取類型：讀取/寫入
限定詞： MappingStrings （「Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|低臨界值事件），單位（「每秒事件數」）

WMI 開始減緩新事件的傳遞速度。為了因應提供者和用戶端之間的速度差異，WMI 會在將事件傳遞給取用者之前先排入佇列。為了提高效率，取用者必須以符合提供者的步調收集物件。如果佇列失控，WMI 節流會變慢，事件傳遞會逐漸與用戶端速率保持一致。當產生事件的速率超過這個屬性的值時，就會開始此速度變慢。請參閱 HighThresholdOnEvents 。

注意

節流只會針對永久事件取用者執行，因此暫時取用者不應該預期在 WMI 內部事件佇列中備份事件時進行節流。

這個屬性會反映登錄值。

HKEY_LOCAL_MACHINE \ 軟體 \ Microsoft \ WBEM CIMOM| \ 用戶端物件 {B} 的高臨界值

MaxLogFileSize

資料類型： uint32
存取類型：讀取/寫入
限定詞： MappingStrings （「Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|記錄檔大小上限）、單位（「bytes」）

WMI 服務所產生的記錄檔大小上限。

這個屬性會反映登錄機碼中的值。

\ HKEY_LOCAL_MACHINE軟體 \ Microsoft \ WBEM|CIMOM|記錄檔大小上限

MaxWaitOnClientObjects

資料類型： uint32
存取類型：讀取/寫入
限定詞： MappingStrings （「Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|最大等候事件）、單位（「毫秒」）

新建立的物件在捨棄之前等候用戶端使用的時間量，並傳回錯誤值。這個屬性會與 LowThresholdOnClientObjects 和 HighThresholdOnClientObjects 屬性互動，以節流-變慢—取用者在取用者收到物件太慢時，將物件傳遞至取用者。

MaxWaitOnEvents

資料類型： uint32
存取類型：讀取/寫入
限定詞： MappingStrings （「Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|最大等候事件）、單位（「毫秒」）

傳送至用戶端的事件在捨棄之前排入佇列的時間量。這個屬性會與 LowThresholdOnEvents 和 HighThresholdOnEvents 互動，以節流速度變慢—當取用者收到物件太慢時，將物件傳遞至取用者。

這個屬性會反映登錄值。

HKEY_LOCAL_MACHINE \ 軟體 \ Microsoft \ WBEM CIMOM| \ 最大等候事件（毫秒）

MofSelfInstallDirectory

資料類型：字串
存取類型：唯讀
限定詞： MappingStrings （「Win32Registry|Software\\Microsoft\\WBEM|MOF 自我安裝目錄「）

將 MOF 檔案安裝至 WMI 存放庫之應用程式的目錄路徑。 WMI 會自動編譯放置在此目錄中的任何 MOF 檔案，並根據其成功，將 MOF 移至標示為良好或錯誤的子目錄。如果包含 # pragma autorecover 命令，則會將完整檔案名新增至 WMI 初始化或復原存放庫時所使用的 AutorecoverMofs 清單。此清單會決定編譯 MOF 的順序。

這個屬性會反映登錄機碼中的值。

\ HKEY_LOCAL_MACHINE軟體 \ Microsoft \ WBEM|CIMOM|MOF Self=Install Directory

SettingID

資料類型：字串
存取類型：唯讀
限定詞： MaxLen （256）

目前物件的已知標識碼。

此屬性繼承自 CIM_Setting。

備註

Win32_WMISetting類別衍生自 CIM_Setting。計算機上只能有一個這個類別的實例。

當您偵錯腳本或針對 WMI 服務本身的問題進行疑難解答時，瞭解電腦上設定 WMI 的方式可能非常有用。例如，許多 WMI 腳本都是根據 root\cimv2 是目標電腦上的預設命名空間所撰寫。因此，需要存取「Root\CIMv2」中類別的腳本寫入器通常無法在 GetObject Moniker 中包含命名空間，如下列程式代碼範例所示：

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

如果 root\cimv2 不是目標電腦上的預設命名空間，此腳本將會失敗。若要防止這種情況發生，命名空間 root\cimv2 必須包含在 moniker 中，如下列程式代碼範例所示：

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

如果目標電腦上的預設命名空間與腳本所假設的命名空間不同，腳本將會失敗。除此之外，使用者會看到一些誤導性的錯誤訊息「無效的類別」。事實上，失敗不是因為類別無效，而是因為無法在預設命名空間中找到類別。這是疑難解答的困難問題，因為您可能會調查類別的可能問題，而不是指定命名空間的問題（或在此案例中未指定）。

您可以使用 Win32_WMISetting 類別來判斷電腦上設定 WMI 的方式。設定詳細數據，例如預設命名空間或WMI組建編號，在針對腳本問題進行疑難解答時很有用。這些設定也會提供重要的系統管理資訊，例如，如果您需要重建 WMI 存放庫，WMI 錯誤是否記錄在電腦，以及哪些 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
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	Wbemcore.dll

另請參閱

CIM_Setting
WMI 服務管理類別

共用方式為

Win32_WMISetting 類別

語法

成員

屬性

備註

範例

需求

另請參閱

意見反應

意見反應

其他資源