ActiveScriptEventConsumer 類別
ActiveScriptEventConsumer 類別會在事件傳遞至該腳本時,以任意指令碼語言執行預先定義的腳本。 這個類別是 WMI 提供的其中一個標準事件取用者。 如需詳細資訊,請參閱 使用標準取用者 監視和回應事件。
Mofcomp -n:root\<namespace> scrcons.mof
您可以在單一 ScriptingStandardConsumerSetting 的單一實例中設定 Timeout 或 MaximumScripts 屬性的值 ,以設定系統上所有 ActiveScriptEventConsumer 實例的 效能 。
語法
[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;
};
成員
ActiveScriptEventConsumer 類別具有下列類型的成員:
屬性
ActiveScriptEventConsumer 類別具有這些屬性。
-
CreatorSID
-
-
資料類型: uint8 陣列
-
存取類型:唯讀
陣列,表示安全性識別碼 (SID),可唯一識別 Active Script 事件取用者的建立者。 此屬性繼承自 __EventConsumer 。
-
-
KillTimeout
-
-
資料類型: uint32
-
存取類型:唯讀
允許腳本執行的秒數。 如果為預設值 0 (零),則不會終止腳本。
-
-
MachineName
-
-
資料類型: 字串
-
存取類型:唯讀
WMI 傳送事件的電腦名稱稱。 根據 Microsoft 標準取用者的慣例,腳本取用者無法從遠端執行。 協力廠商取用者也可以使用這個屬性。 此屬性繼承自 __EventConsumer 。
-
-
MaximumQueueSize
-
-
資料類型: uint32
-
存取類型:唯讀
Active Script 事件取用者的最大佇列,以位元組為單位。 此屬性繼承自 __EventConsumer 。
-
-
名稱
-
-
資料類型: 字串
-
存取類型:讀取/寫入
-
限定詞: 索引鍵
事件取用者的唯一識別碼。 如果您重新命名取用者,結果會是兩個具有相同名稱的取用者。
-
-
ScriptFileName
-
-
資料類型: 字串
-
存取類型:唯讀
要從中讀取腳本文字的檔案名,做為在 ScriptText 屬性中 指定腳本文字的替代方式。 如果 ScriptText 屬性不是 Null, 這個屬性必須是 Null 。
注意
當您指定 ScriptFileName 時,請務必保護您要啟動的可執行檔。 如果可執行檔不在安全的位置或受到強存取控制清單 (ACL) 保護,任何人都可以以不同的可執行檔取代可執行檔。 如需 ACL 的詳細資訊,請參閱 在 C++ 中為新物件建立安全性描述元 (SD)。
-
-
ScriptingEngine
-
-
資料類型: 字串
-
存取類型:唯讀
要使用的腳本引擎名稱,例如 「VBScript」。 這個屬性不可以是 Null 。
-
-
ScriptText
-
-
資料類型: 字串
-
存取類型:唯讀
以腳本引擎已知語言表示的腳本文字。 如果 ScriptFileName 屬性不是 Null, 這個屬性必須是 Null 。
-
備註
這個類別衍生自 抽象類別__EventConsumer 。 它位於 root\subscription 命名空間中。
在事件取用者實例中指定腳本的文字時,腳本可以存取腳本環境變數 TargetEvent 中的事件實例。
腳本會在 LocalSystem 安全性內容中執行。 身為安全性措施,只有本機系統管理員或網域系統管理員可以設定腳本取用者。 在執行時間之前,不會檢查存取權限。 設定取用者之後,任何使用者都可以觸發造成腳本的事件。
無法載入腳本引擎或剖析並驗證腳本被視為失敗。 腳本的錯誤傳回碼以及使用逾時終止腳本也會被視為失敗。
ScriptText 或 ScriptFileName 不得 為 Null 。 如果這兩個屬性都是 Null 或非 Null ,則會產生錯誤。
當 WMI 以服務的形式執行時,ActiveScriptEventConsumer 執行的 腳本不會產生螢幕輸出。 使用 MsgBox 的腳本會執行,但不會在螢幕上顯示資訊。 不支援以可執行檔的形式執行 WMI 服務,但 WMI 允許使用 MsgBox 函式的腳本顯示輸出或接受使用者輸入。 無法使用 WScript 物件所提供的 方法,因為 ActiveScriptEventConsumer 不會使用 Windows 腳本主機 (WSH)。
需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
Namespace |
Root\subscription |
MOF |
|
DLL |
|