Kelas ActiveScriptEventConsumer
Kelas ActiveScriptEventConsumer menjalankan skrip yang telah ditentukan sebelumnya dalam bahasa pembuatan skrip arbitrer saat peristiwa dikirimkan ke dalamnya. Kelas ini adalah salah satu konsumen peristiwa standar yang disediakan WMI. Untuk informasi selengkapnya, lihat Memantau dan Merespons Peristiwa dengan Konsumen Standar.
Mofcomp -n:root\<namespace> scrcons.mof
Anda dapat mengonfigurasi performa semua instans ActiveScriptEventConsumer pada sistem dengan mengatur nilai properti Timeout atau MaximumScripts dalam satu instans ScriptingStandardConsumerSetting.
Sintaks
[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;
};
Anggota
Kelas ActiveScriptEventConsumer memiliki jenis anggota ini:
Properti
Kelas ActiveScriptEventConsumer memiliki properti ini.
-
CreatorSID
-
-
Jenis data: array uint8
-
Jenis akses: Baca-saja
Array yang mewakili pengidentifikasi keamanan (SID), yang secara unik mengidentifikasi pembuat konsumen Peristiwa Skrip Aktif. Properti ini diwariskan dari __EventConsumer.
-
-
KillTimeout
-
-
Jenis data: uint32
-
Jenis akses: Baca-saja
Angka, dalam detik, bahwa skrip diizinkan untuk dijalankan. Jika 0 (nol), yang merupakan default, skrip tidak dihentikan.
-
-
MachineName
-
-
Jenis data: string
-
Jenis akses: Baca-saja
Nama komputer tempat WMI mengirim peristiwa. Berdasarkan konvensi konsumen standar Microsoft, konsumen skrip tidak dapat dijalankan dari jarak jauh. Konsumen pihak ketiga juga dapat menggunakan properti ini. Properti ini diwariskan dari __EventConsumer.
-
-
Ukuran Antrean Maksimum
-
-
Jenis data: uint32
-
Jenis akses: Baca-saja
Antrean maksimum, dalam byte, untuk konsumen Peristiwa Skrip Aktif. Properti ini diwariskan dari __EventConsumer.
-
-
Nama
-
-
Jenis data: string
-
Jenis akses: Baca/tulis
-
Kualifikasi: Kunci
Pengidentifikasi unik untuk konsumen peristiwa. Jika Anda mengganti nama konsumen, hasilnya adalah dua konsumen yang sama yang memiliki nama yang berbeda.
-
-
ScriptFileName
-
-
Jenis data: string
-
Jenis akses: Baca-saja
Nama file tempat teks skrip dibaca, dimaksudkan sebagai alternatif untuk menentukan teks skrip di properti ScriptText . Properti ini harus NULL jika properti ScriptText bukan NULL.
Catatan
Saat Anda menentukan ScriptFileName, penting untuk mengamankan executable yang Anda luncurkan. Jika executable tidak berada di lokasi yang aman atau diamankan dengan daftar kontrol akses (ACL) yang kuat, siapa pun dapat mengganti executable dengan yang berbeda. Untuk informasi selengkapnya tentang ACL, lihat Membuat Deskriptor Keamanan (SD) untuk Objek Baru di C++.
-
-
ScriptingEngine
-
-
Jenis data: string
-
Jenis akses: Baca-saja
Nama mesin pembuatan skrip yang akan digunakan, misalnya, "VBScript". Properti ini tidak boleh NULL.
-
-
Teks Skrip
-
-
Jenis data: string
-
Jenis akses: Baca-saja
Teks skrip yang dinyatakan dalam bahasa yang diketahui oleh mesin pembuatan skrip. Properti ini harus NULL jika properti ScriptFileName bukan NULL.
-
Keterangan
Kelas ini berasal dari kelas abstrak __EventConsumer. Ini terletak di namespace layanan root\subscription.
Ketika teks skrip ditentukan dalam instans konsumen peristiwa, skrip memiliki akses ke instans peristiwa dalam variabel lingkungan skrip TargetEvent.
Skrip berjalan dalam konteks keamanan LocalSystem. Sebagai langkah keamanan, hanya administrator sistem lokal atau administrator domain yang dapat mengonfigurasi konsumen pembuatan skrip. Hak akses tidak diperiksa hingga durasi. Setelah konsumen dikonfigurasi, setiap pengguna dapat memicu peristiwa yang menyebabkan skrip menjadi .
Kegagalan untuk memuat mesin skrip atau mengurai dan memvalidasi skrip dianggap gagal. Kode pengembalian kesalahan dari skrip dan mengakhiri skrip dengan menggunakan waktu habis juga dianggap sebagai kegagalan.
ScriptText atau ScriptFileName tidak boleh NULL. Jika kedua properti null atau bukan NULL, kesalahan dihasilkan.
Saat WMI dijalankan sebagai layanan, skrip yang dijalankan oleh ActiveScriptEventConsumer tidak menghasilkan output layar. Skrip yang menggunakan MsgBox memang berjalan, tetapi tidak menampilkan informasi di layar. Menjalankan layanan WMI sebagai file yang dapat dieksekusi tidak didukung, tetapi WMI memungkinkan skrip yang menggunakan fungsi MsgBox untuk menampilkan output atau menerima input pengguna. Tidak ada metode yang disediakan oleh objek WScript yang dapat digunakan karena ActiveScriptEventConsumer tidak menggunakan Windows Script Host (WSH).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\subscription |
| MOF |
|
| DLL |
|