使用內容物件搭配效能監控工具

內容物件是指令碼與 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, "指令碼順利完成。"); //Success
Context.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");