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

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

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

方法

方法說明

LogMessage(sText);

此方法可將訊息寫入 WhatsUp Gold 偵錯記錄檔。

範例

JScript


        Context.LogMessage("使用 Context.GetProperty() 檢查監控工具名稱");
       

VBScript


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

PutProperty(sPropertyName);

此方法可讓您將數值存入 INMSerialize 物件。無論輪詢幾次,系統都會保留此值。(此方法僅適用於動態指令碼。)

範例

JScript


        var nCount = parselnt(nNum) +1;Context.PutProperty("MyNumeric",nCount);
       

SetProperty(sPropertyName);

此方法可讓您將數值存入 INMSerialize 物件。無論輪詢幾次,系統都會保留此值。(此方法僅適用於 PowerShell。)

SetResult(nCode, sText);

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

每個指令碼都必須呼叫 SetResult。若未呼叫 SetResult,則一律認定指令碼成功。

範例

JScript


        Context.SetResult(0, "指令碼順利完成。"); //SuccessContext.SetResult(1, "發生錯誤。"); //Failure
       

VBScript


        Context.SetResult 1, "發生錯誤。"
       

GetReferenceVariable(sRefVarName );

此方法可讓程式碼取得要用於監控工具的參考變數。

範例

JScript


        Context.GetReferenceVariable("A")
       

您必須先建立參考變數「A」。

SetValue(nValue);

此方法可讓您以圖形表示數值。

範例

JScript


        Context.SetValue(245)
       

GetProperty(sPropertyName);

此方法可讓您存取下列任何裝置屬性。這些名稱有大小寫之分。

屬性

說明

"ActiveMonitorTypeName"

主動監控工具顯示名稱

"Address"

裝置的 IP 位址

"DeviceID"

裝置 ID

"Mode"

1 = 執行探索 2 = 輪詢 3 = 測試

"ActiveMonitorTypeID"

主動監控工具的類型 ID

"CredSnmpV1:ReadCommunity"

SNMP V1 讀取群體

"CredSnmpV1:WriteCommunity"

SNMP V1 寫入群體

"CredSnmpV2:ReadCommunity"

SNMP V2 讀取群體

"CredSnmpV2:WriteCommunity"

SNMP V2 寫入群體

"CredSnmpV3:Username"

SNMP V3 使用者名稱

"CredSnmpV3:Context"

SNMP V3 環境

"CredSnmpV3:AuthPassword"

SNMP V3 身分驗證密碼

"CredSnmpV3:AuthProtocol"

SNMP V3 身分驗證通訊協定

"CredSnmpV3:EncryptPassword"

SNMP V3 加密密碼

"CredSnmpV3:EncryptProtocol"

SNMP V3 加密通訊協定

"CredWindows:DomainAndUserid"

Windows NT 網域和使用者 ID

"CredWindows:Password"

Windows NT 密碼

範例

JScript


        var sAddress = Context.GetProperty("Address"); var sReadCommunity = Context.GetProperty("CredSnmpV1:ReadCommunity");var nDeviceID = Context.GetProperty("DeviceID");