Win32_WMISetting 类

项目
06/12/2023

Win32_WMISetting单一实例 WMI 类包含 WMI 服务的操作参数。此类只能有一个实例，每个 Windows 系统始终存在该实例，并且无法删除。无法创建其他实例。

以下语法从托管对象格式 (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

数据类型： string
访问类型：读/写
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM\\scripting|默认命名空间“)

默认脚本命名空间。此属性包含来自 WMI 脚本 API 的调用所使用的命名空间（如果调用方未指定任何命名空间）。

此属性反映注册表项中的值。

\ HKEY_LOCAL_MACHINE软件\微软\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软件\微软\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 |最大数据库大小“) ，单位 (”千字节“)

WMI 存储库的最大大小。

描述

数据类型： string
访问类型：只读

当前对象的文本说明。

此属性继承自 CIM_Setting。

EnableAnonWin9xConnections

数据类型： 布尔值
访问类型：读/写
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM |EnableAnonConnections“)

不支持。

EnableEvents

数据类型： 布尔值
访问类型：读/写
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM |EnableEvents“)

如果 为 True，则应启用 WMI 事件子系统。

此属性反映注册表项中的值。

\ HKEY_LOCAL_MACHINE软件\微软\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软件\微软\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 |Logging Directory“)

包含 WMI 系统日志文件位置的目录路径。

此属性反映注册表项中的值。

\ HKEY_LOCAL_MACHINE软件\微软\WBEM |CIMOM |日志记录目录

LoggingLevel

数据类型： uint32
访问类型：读/写
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM |Logging“)

启用事件日志记录和所使用的日志记录的详细级别。

此属性反映注册表项中的值。

\ HKEY_LOCAL_MACHINE软件\微软\WBEM |CIMOM |测井

关闭 (0)

日志记录 (1) 错误

日志记录 (2) 详细错误

LowThresholdOnClientObjects

数据类型： uint32
访问类型：读/写
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM |客户端对象的低阈值“) ，单位 (”每秒对象数“)

WMI 开始减慢为客户端创建的新对象的创建速度。为了适应提供程序和客户端之间的速度差异，WMI 在将对象传递给使用者之前将对象保留在队列中。为了提高效率，使用者必须按照与提供程序匹配的速度收集对象。如果对象的请求速率达到 LowThresholdOnClientObjects，则 WMI 会逐渐减慢新对象的创建速度，以匹配客户端的使用率。当对象的创建速率超过此属性的值时，就会开始出现此速度减慢。请参阅 HighThresholdOnClientObjects。

此属性反映注册表值。

KEY_LOCAL_MACHINE\软件\微软\WBEM\ CIMOM |客户端对象的高阈值 (B)

LowThresholdOnEvents

数据类型： uint32
访问类型：读/写
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM |低阈值事件“) ，单位 (”每秒事件数“)

WMI 开始减慢新事件的传递速度。为了适应提供程序和客户端之间的速度差异，WMI 先将事件排队，然后再将其传送给使用者。为了提高效率，使用者必须按照与提供程序匹配的速度收集对象。如果队列增长失控，WMI 会逐渐限制事件传送速度，以与客户端速率保持一致。当生成事件的速率超过此属性的值时，就会开始出现此减速。请参阅 HighThresholdOnEvents。

注意

限制仅适用于永久事件使用者，因此，在 WMI 内部事件队列中备份事件时，临时使用者不应期望限制。

此属性反映注册表值。

\ HKEY_LOCAL_MACHINE软件\微软\WBEM\ CIMOM |客户端对象上的高阈值 {B}

MaxLogFileSize

数据类型： uint32
访问类型：读/写
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM\\CIMOM |日志文件最大大小“) ，单位 (”字节“)

WMI 服务生成的日志文件的最大大小。

此属性反映注册表项中的值。

\ HKEY_LOCAL_MACHINE软件\微软\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软件\微软\WBEM\ CIMOM |最大等待事件 (ms)

MofSelfInstallDirectory

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32Registry|Software\\Microsoft\\WBEM |MOF Self-Install Directory“)

将 MOF 文件安装到 WMI 存储库的应用程序的目录路径。 WMI 会自动编译放置在此目录中的任何 MOF 文件，并根据其成功情况将 MOF 移动到标记为“好”或“坏”的子目录。如果包含 # pragma autorecover 命令，则会将完全限定的文件名添加到 WMI 初始化或恢复存储库时使用的 AutorecoverMofs 列表中。该列表确定 MOF 的编译顺序。

此属性反映注册表项中的值。

\ HKEY_LOCAL_MACHINE软件\微软\WBEM |CIMOM |MOF Self=Install Directory

SettingID

数据类型： 字符串
访问类型：只读
限定符： MaxLen (256)

已知当前对象的标识符。

此属性继承自 CIM_Setting。

备注

Win32_WMISetting 类派生自 CIM_Setting。计算机上只能存在此类的一个实例。

在调试脚本或排查 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 设置列表。

列出 WMI 设置信息对象 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 类

语法

成员

属性

备注

示例

要求

另请参阅

反馈

反馈

其他资源