класс Win32_WMISetting

  • Статья

Одноэлементный класс WMIWin32_WMISetting содержит рабочие параметры для службы 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

Тип данных: string

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

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

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

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

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

Пример: root\cimv2

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

ASPScriptEnabled

Тип данных: boolean

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

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

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

Автовосстановка

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

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

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

Список полных имен 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

Тип данных: string

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

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

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

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

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

HKEY_LOCAL_MACHINE\Программного обеспечения\Microsoft\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

Тип данных: boolean

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

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

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

EnableEvents

Тип данных: boolean

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

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

Если задано значение True, должна быть включена подсистема событий WMI.

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

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

EnableStartupHeapPreallocation

Тип данных: boolean

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

Квалификаторы: 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

Тип данных: string

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

Квалификаторы: 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

Тип данных: string

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

Квалификаторы: 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| Максимальное время ожидания событий"), единицы ("миллисекунда")

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

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

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

MofSelfInstallDirectory

Тип данных: string

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

Квалификаторы: MappingStrings ("Win32Registry| | Программное обеспечение\\Microsoft\\WBEM| MOF Self-Install Directory")

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

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

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

SettingID

Тип данных: string

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

Квалификаторы: 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.

Примеры

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

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

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

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

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

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