使用內容物件搭配效能監控工具
內容物件是指令碼與 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");
|