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

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

註: 從說明檔複製程式碼時若出現版權資訊,可能會需要從剪下貼上中移除版權資訊。

方法

方法說明

LogMessage(sText);

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

範例

JScript

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

VBScript

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

SetResult(LONG nCode, sText);

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

範例

JScript

Context.SetResult(0, "指令碼順利完成。"); //SuccessContext.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 裝置為離線 108 APM 動作

"CredWindows:DomainAndUserid"

Windows NT 網域和使用者 ID

只有在啟用模擬功能時才能使用這個內容物件。

"CredWindows:Password"

Windows NT 密碼

只有在啟用模擬功能時才能使用這個內容物件。

範例

JScript

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