Класс ActiveScriptEventConsumer

Класс ActiveScriptEventConsumer запускает предварительно определенный скрипт на произвольном языке сценариев при доставке события в него. Этот класс является одним из стандартных потребителей событий, которые предоставляет WMI. Дополнительные сведения см. в разделе "Мониторинг и реагирование на события" с помощью стандартных потребителей.

Mofcomp -n:root\<namespace> scrcons.mof

Производительность всех экземпляров ActiveScriptEventConsumer в системе можно настроить, задав значения свойства Timeout или MaximumScripts в одном экземпляре ScriptingStandardConsumerSetting.

Синтаксис

[AMENDMENT]
class ActiveScriptEventConsumer : __EventConsumer
{
  uint8  CreatorSID[] = {1,1,0,0,0,0,0,5,18,0,0,0};
  uint32 KillTimeout = 0;
  string MachineName;
  uint32 MaximumQueueSize;
  string Name;
  string ScriptingEngine;
  string ScriptFileName;
  string ScriptText;
};

Участники

Класс ActiveScriptEventConsumer имеет следующие типы элементов:

• Свойства

Свойства

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

CreatorSID

Тип данных: массив uint8

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

Массив, представляющий идентификатор безопасности (SID), который однозначно идентифицирует создателя объекта "Событие активного скрипта". Это свойство наследуется от __EventConsumer.

KillTimeout

Тип данных: uint32

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

Число в секундах, в течение которых скрипт может выполняться. Если значение равно 0 (ноль), то по умолчанию скрипт не завершается.

MachineName

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

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

Имя компьютера, на который WMI отправляет события. По соглашению стандартных потребителей Майкрософт потребитель скрипта не может выполняться удаленно. Сторонние потребители также могут использовать это свойство. Это свойство наследуется от __EventConsumer.

MaximumQueueSize

Тип данных: uint32

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

Максимальная очередь (в байтах) для потребителя события активного скрипта. Это свойство наследуется от __EventConsumer.

Имя

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

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

Квалификаторы: ключ

Уникальный идентификатор для потребителя события. При переименовании потребителя результатом является два равных потребителей с разными именами.

ScriptFileName

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

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

Имя файла, из которого читается текст скрипта, предназначенного в качестве альтернативы указанию текста скрипта в свойстве ScriptText . Это свойство должно иметь значение NULL, если свойство ScriptText не равно NULL.

Примечание.

При указании ScriptFileName важно защитить исполняемый файл, который вы запускаете. Если исполняемый файл не находится в безопасном расположении или защищен с помощью строгого списка управления доступом (ACL), любой пользователь может заменить исполняемый файл другим. Дополнительные сведения о списках управления доступом см. в статье о создании дескриптора безопасности (SD) для нового объекта в C++.

ScriptingEngine

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

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

Имя обработчика сценариев, используемого, например "VBScript". Это свойство не может иметь значение NULL.

ScriptText

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

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

Текст скрипта, который выражается на языке, известном обработчику сценариев. Это свойство должно иметь значение NULL, если свойство ScriptFileName не равно NULL.

Замечания

Этот класс является производным от __EventConsumer абстрактного класса. Он расположен в пространстве имен root\subscription.

Если текст скрипта указан в экземпляре потребителя события, скрипт имеет доступ к экземпляру события в переменной среды скрипта TargetEvent.

Скрипты выполняются в контексте безопасности LocalSystem. В качестве меры безопасности только локальный системный администратор или администратор домена могут настроить потребителя скриптов. Права доступа не проверка до времени выполнения. После настройки потребителя любой пользователь может активировать событие, вызывающее скрипт.

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

ScriptText или ScriptFileName не должны иметь значение NULL. Если оба свойства имеют значение NULL или нет NULL, создается ошибка.

При запуске WMI в качестве службы скрипты, выполняемые ActiveScriptEventConsumer , не создают выходные данные экрана. Скрипты, использующие msgBox , выполняются, но они не отображают информацию на экране. Запуск службы WMI в качестве исполняемого файла не поддерживается, но WMI позволяет скриптам, используюющим функцию MsgBox отображать выходные данные или принимать входные данные пользователя. Ни один из методов, предоставляемых объектом WScript, не может использоваться, так как ActiveScriptEventConsumer не использует узел скриптов Windows (WSH).

Требования

См. также

Стандартные классы потребителей

Выполнение скрипта на основе события

Получение событий в любое время

Создание логического потребителя

__EventConsumer

ScriptingStandardConsumerSetting