класс Win32_WMISetting

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 имеет следующие типы элементов:

Элемент Property

Класс Win32_WMISetting имеет эти свойства.

ASPScriptDefaultNamespace

Тип данных: строка

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\scripting| Пространство имен по умолчанию")

Пространство имен скрипта по умолчанию. Это свойство содержит пространство имен, используемое вызовами ИЗ API скриптов для WMI, если ни один из них не указан вызывающим объектом.

Это свойство отражает значение в разделе реестра.

HKEY_LOCAL_MACHINE\Программного обеспечения\Microsoft\WBEM\    скрипты| Пространство имен по умолчанию

Пример: root\cimv2

Пример сценария, использующего это свойство, см. в разделе "Примечания".

ASPScriptEnabled

Тип данных: логическое значение

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\scripting| Включить для ASP")

Если задано значение True, скрипты WMI можно использовать на страницах сервера Active Server (ASP). Это свойство допустимо только в системах, где работают неподдерживаемые версии Windows. Для поддерживаемых Windows систем скрипты WMI всегда разрешены в ASP.

AutorecoverMofs

Тип данных: строковый массив

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Автоматическое ревосстановка MOFS")

Список полных имен MOF-файлов, используемых для инициализации или восстановления репозитория WMI. Список определяет порядок компиляции 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| Сборка")

Сведения о версии для текущей установленной службы WMI.

Продолжительность времени, прошедшего между резервными копиями базы данных WMI.

Это свойство отражает значение в разделе реестра.

HKEY_LOCAL_MACHINE\Программного обеспечения\Microsoft\WBEM| Построить

Caption

Тип данных: строка

Тип доступа: только для чтения

Квалификаторы: MaxLen (64)

Краткое текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

DatabaseDirectory

Тип данных: строка

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Каталог репозитория")

Путь к каталогу, содержащий репозиторий WMI.

DatabaseMaxSize

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Максимальный размер базы данных"), единицы ("килобайты")

Максимальный размер репозитория WMI.

Описание

Тип данных: строка

Тип доступа: только для чтения

Текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

EnableAnonWin9xConnections

Тип данных: логическое значение

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableAnonConnections")

Не поддерживается.

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 создает предварительно выделенную кучу с размером значения LastStartupHeapPreallocation при инициализации WMI.

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), единицы ("байты")

Размер предварительно выделенной кучи, созданной 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 Программного обеспечения\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| Максимальный размер файла журнала), единицы ("байты")

Максимальный размер файлов журнала, созданных службой WMI.

Это свойство отражает значение в разделе реестра.

HKEY_LOCAL_MACHINE\Программного обеспечения\Microsoft\WBEM| CIMOM| Максимальный размер файла журнала

MaxWaitOnClientObjects

Тип данных: uint32

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Max Wait On Events"), Units ("milliseconds")

Время ожидания вновь созданного объекта, которое будет использоваться клиентом до его отмены, и возвращается значение ошибки. Это свойство взаимодействует со свойствами LowThresholdOnClientObjects и HighThresholdOnClientObjects для регулирования — замедления — доставки объектов потребителям, когда потребитель получает объекты слишком медленно.

MaxWaitOnEvents

Тип данных: uint32

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Max Wait On Events"), Units ("milliseconds")

Время, в течение которого событие, отправленное клиенту, помещается в очередь перед удалением. Это свойство взаимодействует с LowThresholdOnEvents и HighThresholdOnEvents для регулирования — замедления — доставки объектов потребителям, когда потребитель получает объекты слишком медленно.

Это свойство отражает значение реестра.

HKEY_LOCAL_MACHINE\Программного обеспечения\Microsoft\WBEM\    CIMOM| Максимальное ожидание событий (мс)

MofSelfInstallDirectory

Тип данных: строка

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| MOF Self-Install Directory")

Путь к каталогу для приложений, устанавливающих MOF-файлы в репозиторий WMI. WMI автоматически компилирует все MOF-файлы, размещенные в этом каталоге, и в зависимости от успешного выполнения MOF перемещает MOF в подкаталог с меткой "хороший" или "плохой". Если включена команда автовосстановления #pragma , полное имя файла добавляется в список autorecoverMofs , используемый при инициализации или восстановлении репозитория WMI. Список определяет порядок компиляции MOFS.

Это свойство отражает значение в разделе реестра.

HKEY_LOCAL_MACHINE\Программного обеспечения\Microsoft\WBEM| CIMOM| MOF Self=Install Directory

SettingID

Тип данных: строка

Тип доступа: только для чтения

Квалификаторы: MaxLen (256)

Идентификатор, по которому известен текущий объект.

Это свойство наследуется от CIM_Setting.

Remarks

Класс Win32_WMISetting является производным от CIM_Setting. На компьютере может существовать только один экземпляр этого класса.

Зная, как WMI настроен на компьютере, может быть очень полезно при отладке скриптов или устранении неполадок с самой службой WMI. Например, многие скрипты WMI записываются в предположении, что root\cimv2 является пространством имен по умолчанию на целевом компьютере. В результате записи скриптов, которым требуется доступ к классу в Root\CIMv2, часто не могут включать пространство имен в моникер GetObject, как показано в следующем примере кода:

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

Если root\cimv2 не является пространством имен по умолчанию на целевом компьютере, этот сценарий завершится ошибкой. Чтобы предотвратить это, корневой каталог пространства имен\cimv2 должен быть включен в моникер, как показано в следующем примере кода:

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

Если пространство имен по умолчанию на целевом компьютере отличается от пространства имен, предполагаемого скриптом, сценарий завершится ошибкой. Кроме того, пользователю будет предоставлено несколько вводящее в заблуждение сообщение об ошибке "Недопустимый класс". По правде говоря, сбой заключается не в том, что класс недопустим, а потому, что класс не найден в пространстве имен по умолчанию. Это сложная проблема для устранения неполадок, так как вы, скорее всего, изучите возможные проблемы с классом, а не проблемы с пространством имен, которое было (или, в данном случае, не указано).

Класс Win32_WMISetting можно использовать для определения настройки WMI на компьютере. Сведения о конфигурации, такие как пространство имен по умолчанию или номер сборки WMI, могут быть полезны при устранении неполадок скрипта. Эти параметры также предоставляют важную административную информацию, например о том, как или даже регистрируются ошибки WMI на компьютере и какие поставщики WMI будут автоматически перезагружены, если необходимо перестроить репозиторий WMI.

Примеры

В примере кода Modify WMI Параметры VBScript в коллекции TechNet используется класс Win32_WMISetting для настройки интервала резервного копирования WMI и уровня ведения журнала.

В примере кода VBScript пространства имен по умолчанию в коллекции TechNet используется класс Win32_WMISetting для получения и отображения текущего параметра WMI "Пространство имен по умолчанию для создания скриптов".

В примере кода VBScript пространства имен WMI по умолчанию в коллекции TechNet используется свойство ASPScriptDefaultNamespace , чтобы задать для параметра WMI "Пространство имен по умолчанию для создания скриптов" значение root\cimv2.

В примере кода List All the WMI Параметры VBSCript используется ряд свойств Win32_WMISetting для возврата списка параметров WMI, настроенных на компьютере.

В примере кода JavaScript для параметров WMI списка используется ряд свойств в Win32_WMISetting для возврата списка параметров WMI, настроенных на компьютере.

В примере кода параметра WMI списка Python используется ряд свойств в Win32_WMISetting для возврата списка параметров WMI, настроенных на компьютере.

В примере кода REXX параметра WMI списка используется ряд свойств в 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