共用方式為


Win32_WMISetting 類別

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 服務管理類別