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 |
|
| DLL |
|