Bagikan melalui


Kelas LogFileEventConsumer

Kelas LogFileEventConsumer menulis string yang dikustomisasi ke file log teks saat peristiwa dikirimkan ke dalamnya. String dipisahkan oleh urutan akhir baris. Kelas ini adalah salah satu konsumen peristiwa standar yang disediakan WMI. Untuk informasi selengkapnya, lihat Memantau dan Merespons Peristiwa dengan Konsumen Standar.

Sintaks

[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
  uint8   CreatorSID[];
  string  MachineName;
  uint32  MaximumQueueSize;
  string  Filename;
  boolean IsUnicode;
  uint64  MaximumFileSize = 65535;
  string  Name;
  string  Text;
};

Anggota

Kelas LogFileEventConsumer memiliki jenis anggota ini:

Properti

Kelas LogFileEventConsumer memiliki properti ini.

CreatorSID

Jenis data: array uint8

Jenis akses: Baca-saja

Pengidentifikasi keamanan (SID) yang secara unik mengidentifikasi pengguna yang membuat filter. WMI menyimpan SID pengguna yang membuat instans __EventConsumer atau Administrator SID, tergantung pada sistem operasi. Untuk informasi selengkapnya, lihat Mengikat Filter Peristiwa dengan Konsumen Logis dan Memantau dan Merespons Peristiwa dengan Konsumen Standar.

Properti ini diwarisi dari __EventConsumer.

Filename

Jenis data: string

Jenis akses: Baca-saja

Nama file yang menyertakan jalur tempat entri log ditambahkan. Jika file tidak ada, LogFileEventConsumer mencoba membuatnya. Konsumen gagal ketika jalur tidak ada, atau ketika pengguna yang membuat konsumen tidak memiliki izin tulis untuk file atau jalur.

IsUnicode

Jenis data: boolean

Jenis akses: Baca-saja

Jika TRUE, file log adalah file teks Unicode. Jika FALSE, file log adalah file teks kode multibyte. Jika file ada, properti ini diabaikan dan pengaturan file saat ini digunakan. Misalnya, jika IsUnicodeadalah FALSE, tetapi file yang ada adalah file Unicode, maka Unicode digunakan. Jika IsUnicodeTRUE, tetapi file adalah kode multibyte, maka kode multibyte digunakan.

MachineName

Jenis data: string

Jenis akses: Baca-saja

Nama komputer tempat Instrumentasi Manajemen Windows (WMI) mengirim peristiwa.

Properti ini diwarisi dari __EventConsumer.

MaximumFileSize

Jenis data: uint64

Jenis akses: Baca-saja

Ukuran maksimum file log dalam byte. Jika file utama melebihi ukuran maksimumnya, konten dipindahkan ke file yang berbeda dan file utama dikosongkan. Nilai 0 (nol) berarti tidak ada batas ukuran. Nilai defaultnya adalah 65.535 byte. Ukuran file diperiksa sebelum operasi tulis. Oleh karena itu, Anda dapat memiliki file yang sedikit lebih besar dari batas ukuran yang ditentukan. Operasi tulis berikutnya menangkapnya dan memulai file baru.

Daftar berikut mengidentifikasi struktur penamaan untuk file cadangan:

  • Jika nama file asli adalah 8,3, ekstensi digantikan oleh string dalam format "001", "002", dan seterusnya dengan angka terkecil yang lebih besar dari semua angka yang digunakan dan dipilih sebelumnya. Jika "999" digunakan, maka angka yang dipilih adalah angka terkecil yang tidak digunakan.
  • Jika nama file asli bukan 8,3, string dalam format "001", "002", dan seterusnya ditambahkan ke nama file.

Untuk informasi selengkapnya tentang menggunakan nilai uint64 dalam skrip, lihat Pembuatan skrip di WMI.

MaximumQueueSize

Jenis data: uint32

Jenis akses: Baca-saja

Antrean maksimum untuk konsumen tertentu, dalam byte.

Properti ini diwarisi dari __EventConsumer.

Nama

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: kunci

Nama unik untuk konsumen ini.

Teks

Jenis data: string

Jenis akses: Baca-saja

Templat string standar untuk teks entri log.

Keterangan

Catatan

LogFileEventConsumer tidak mengamankan file log. Oleh karena itu, ketika Anda mengonfigurasi LogFileEventConsumer, penting untuk menentukan direktori yang diamankan ke tingkat yang Anda butuhkan.

Kelas LogFileEventConsumer berasal dari kelas abstrak __EventConsumer .

Contoh

Untuk contoh penggunaan LogFileEventConsumer untuk membuat konsumen, lihat Menulis ke File Log Berdasarkan Peristiwa.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista
Server minimum yang didukung
Windows Server 2008
Ruang nama
Root\subscription
MOF
Wbemcons.mof
DLL
Wbemcons.dll

Lihat juga

Kelas Konsumen Standar

Menulis ke File Log Berdasarkan Peristiwa

Membuat Konsumen Logis

Menerima Peristiwa Setiap Saat

__EventConsumer