Bagikan melalui


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
Scrcons.mof
DLL
Scrcons.exe

Baca juga

Kelas Konsumen Standar

Menjalankan Skrip Berdasarkan Peristiwa

Menerima peristiwa setiap saat

Membuat Konsumen Logis

__EventConsumer

ScriptingStandardConsumerSetting