使用內容物件搭配動作

內容物件是指令碼與 WhatsUp Gold 互動的介面。

您必須利用 Context 名稱空間擷取所有的方法和特性。

Note: 從說明檔複製程式碼時若出現版權資訊,最好移除貼上的版權資訊。

方法

方法說明

LogMessage(sText);

此方法可將訊息寫入 WhatsUp Gold 偵錯記錄檔。 「事件檢視器」會顯示訊息。

範例

JScript

Context.LogMessage( "使用 Context.GetProperty() 檢查動作名稱");

VBScript

Context.LogMessage "使用 Context.GetProperty() 檢查位址"

SetResult(LONG nCode, sText);

此方法可讓您設定結果代碼和結果訊息。您可以藉此讓 WhatsUp Gold 系統得知動作是否成功。

範例

JScript

Context.SetResult(0, "指令碼順利完成。"); //Success
Context.SetResult(1, "出現錯誤。"); //Failure

VBScript

Context.SetResult 1, "出現錯誤。"

NotifyProgress(sText);

此方法可將訊息寫入動作進度對話方塊。[測試] 和 [執行中動作] 對話方塊會顯示訊息。

範例

JScript

Context.NotifyProgress( "使用 Context.GetProperty() 檢查動作名稱");

VBScript

Context.NotifyProgress "使用 Context.GetProperty() 檢查位址"

IsCancelled();

此方法可測試使用者是否已取消動作。若傳回 true,指令碼就應該終止。

使用者可以在動作進度對話方塊中取消動作,或在關機時由 WhatsUp Gold 軟體引擎取消動作。

GetProperty(sPropertyName);

此特性可讓您存取設備的許多特定部分。您可利用列出的名稱存取這些項目。這些名稱有大小寫之分。

"ActionName"

動作顯示名稱

"Address"

設備的 IP 位址

"Name"

設備的網路名稱

"DisplayName"

設備的顯示名稱

"DeviceID"

設備 ID

"ActionTypeID"

動作類型 ID

"TriggerCondition"

觸發動作的原因。

觸發值:

 1 監控工具由離線轉為上線
 2 監控工具由上線轉為離線
 4 收到一個被動監控工具……
 8 按下 [測試] 按鈕
16 這是週期性動作……
32 設備上線
64 設備離線

範例

JScript

var sAddress = Context.GetProperty("Address");
var nDeviceID = Context.GetProperty("DeviceID");

另請參閱

撰寫動作的指令碼

動態指令碼動作範例