Класс LogFileEventConsumer
Класс LogFileEventConsumer записывает настраиваемые строки в текстовый файл журнала при доставке в него событий. Строки разделяются концевой последовательностью. Этот класс является одним из стандартных потребителей событий, которые предоставляет WMI. Дополнительные сведения см. в разделе Мониторинг и реагирование на события с помощью стандартных потребителей.
Синтаксис
[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
uint8 CreatorSID[];
string MachineName;
uint32 MaximumQueueSize;
string Filename;
boolean IsUnicode;
uint64 MaximumFileSize = 65535;
string Name;
string Text;
};
Члены
Класс LogFileEventConsumer имеет следующие типы членов:
Элемент Property
Класс LogFileEventConsumer имеет следующие свойства.
-
CreatorSID
-
-
Тип данных: массив uint8
-
Тип доступа: только для чтения
Идентификатор безопасности (SID), который однозначно идентифицирует пользователя, создающего фильтр. WMI сохраняет идентификатор безопасности пользователя, создающего экземпляр __EventConsumer , или идентификатор безопасности администратора в зависимости от операционной системы. Дополнительные сведения см. в разделах Привязка фильтра событий к логическому потребителюи Мониторинг и реагирование на события с помощью стандартных потребителей.
Это свойство наследуется от __EventConsumer.
-
-
Имя файла
-
-
Тип данных: string
-
Тип доступа: только для чтения
Имя файла, включающее путь, к которому добавляются записи журнала. Если файл не существует, LogFileEventConsumer пытается создать его. Потребитель завершается ошибкой, если путь не существует или пользователь, создающий объект-получатель, не имеет разрешений на запись для файла или пути.
-
-
IsUnicode
-
-
Тип данных: boolean
-
Тип доступа: только для чтения
Если значение РАВНО TRUE, файл журнала является текстовым файлом Юникода. Если значение РАВНО FALSE, файл журнала является текстовым файлом многобайтового кода. Если файл существует, это свойство игнорируется и используется текущий параметр файла. Например, если isUnicode имеет значение FALSE, а существующий файл является файлом Юникода, используется Юникод. Если isUnicode имеет значение TRUE, но файл является многобайтовый код, используется многобайтовый код.
-
-
MachineName
-
-
Тип данных: string
-
Тип доступа: только для чтения
Имя компьютера, на который инструментарий управления Windows (WMI) отправляет события.
Это свойство наследуется от __EventConsumer.
-
-
MaximumFileSize
-
-
Тип данных: uint64
-
Тип доступа: только для чтения
Максимальный размер файла журнала в байтах. Если размер основного файла превышает его максимальный размер, содержимое перемещается в другой файл, а основной файл очищается. Значение 0 (ноль) означает отсутствие ограничения на размер. Значение по умолчанию — 65 535 байт. Размер файла проверяется перед операцией записи. Таким образом, вы можете иметь файл, который немного больше указанного предела размера. Следующая операция записи перехватывает его и запускает новый файл.
В следующем списке указана структура именования для файла резервной копии:
- Если исходное имя файла — 8.3, расширение заменяется строкой в формате "001", "002" и т. д. с наименьшим числом, превышающим все ранее использованные и выбранные числа. Если используется "999", то выбранное число является наименьшим неиспользуемого числа.
- Если исходное имя файла не равно 8.3, к имени файла добавляется строка в формате "001", "002" и т. д.
Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Создание скриптов в WMI.
-
-
MaximumQueueSize
-
-
Тип данных: uint32
-
Тип доступа: только для чтения
Максимальная очередь для конкретного потребителя в байтах.
Это свойство наследуется от __EventConsumer.
-
-
имя;
-
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: ключ
Уникальное имя для этого потребителя.
-
-
Text
-
-
Тип данных: string
-
Тип доступа: только для чтения
Шаблон стандартной строки для текста записи журнала.
-
Комментарии
Примечание
LogFileEventConsumer не защищает файл журнала. Поэтому при настройке LogFileEventConsumer важно указать каталог, защищенный до необходимого уровня.
Класс LogFileEventConsumer является производным от абстрактного класса __EventConsumer .
Примеры
Пример использования LogFileEventConsumer для создания потребителя см. в разделе Запись в файл журнала на основе события.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\subscription |
| MOF |
|
| DLL |
|