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）。

需求

另請參閱

標準取用者類別

根據事件執行腳本

隨時接收事件

建立邏輯取用者

__EventConsumer

ScriptingStandardConsumerSetting