Managing WMI Settings
Microsoft® Windows® 2000 Scripting Guide
WMI is an example of a self-instrumented service. This simply means that you can use WMI scripts to monitor, configure, and control the WMI service. In fact, WMI scripts can be used to enumerate and configure the following items:
Logging level, file size, and logging folder for the WMI service
Backup interval for the WMI repository
WMI time-out values
Default WMI namespace
The WMI service exposes many of its properties through the Win32_WMISetting class. You can write scripts to return information regarding the configuration of WMI on a computer, such as the error logging level, the location of the WMI repository, or a list of .mof files that will automatically be reinstalled if the repository becomes corrupted.
Table 8.12 includes some of the more commonly used properties found in the Win32_WMISetting class.
Table 8.12 Win32_WMISetting Properties
Property |
Description |
|---|---|
ASPScriptDefaultNamespace |
Default script namespace. Contains the namespace used by calls from the WMI Scripting API if one is not specified by the caller. On most computers, the default namespace is root\cimV2. |
AutoRecoverMOFs |
List of fully qualified Managed Object Format (MOF) file names used to initialize or recover the WMI repository. The list determines the order in which MOF files are compiled. |
BackupInterval |
Length of time that will elapse between backups of the WMI database. |
BackupLastTime |
Time that the last backup of the WMI repository was performed. |
BuildVersion |
Version information for the currently installed WMI service. For Windows 2000, the build version is 1085.0005. |
DatabaseDirectory |
Directory path for the WMI repository. |
EnableEvents |
Indicates whether or not the WMI event subsystem is enabled. |
HighThresholdOnClientObjects |
Maximum rate at which provider-created objects can be delivered to clients. To accommodate speed differentials between providers and clients, WMI holds objects in queues before delivering them to consumers. WMI slows down the addition of new objects into the queue when the low threshold is reached. If this does not help, and high threshold (specified by this property) is reached, WMI accepts no more objects from providers and returns an out-of-memory error to the clients. |
HighThresholdOnEvents |
Maximum rate at which events are to be delivered to clients. To accommodate speed differentials between providers and clients, WMI queues events before delivering them to consumers. WMI slows down the addition of new events into the queue when the low threshold is reached. If this does not help, and high threshold (specified by this property) is reached, WMI accepts no more events from providers and returns an out-of-memory error to the clients. |
LoggingDirectory |
Directory path to the WMI system log files. |
LoggingLevel |
Indicates whether event logging is enabled and the level of logging used. Values include: 0 - No logging 1 - Error logging 2 - Verbose error logging |
LowThresholdOnClientObjects |
Rate at which WMI starts to slow the creation of new objects created for clients. To accommodate speed differentials between providers and clients, WMI holds objects in queues before delivering them to consumers. If the rate of requests for objects grows out of control, WMI gradually slows down the creation of new objects to match the rate used by the client. This slowdown starts when the rate at which objects are being created exceeds the value of this property. The slowdown continues until equilibrium is achieved or the high threshold is reached. |
LowThresholdOnEvents |
Rate at which WMI starts to slow the delivery of new events. To accommodate speed differentials between providers and clients, WMI queues events before delivering them to consumers. If the queue grows out of control, WMI slows down the delivery of events gradually to get them in line with the rate used by the client. This slowdown starts when the rate at which events are generated exceeds the value of this property. The slowdown continues until either the equilibrium is achieved or the high threshold is reached. |
MaxLogFileSize |
Maximum size of the log files produced by the WMI service. |
MaxWaitOnClientObjects |
Amount of time a newly created object waits to be used by the client before it is discarded and an error value is returned. |
MaxWaitOnEvents |
Amount of time for which an event sent to a client is queued before being discarded. |
MOFSelfInstallDirectory |
Directory path for applications that install MOF files to the WMI repository. WMI automatically compiles any MOF files placed in this directory and, depending on its success, moves the MOF to a subdirectory labeled good or bad. |