使用内容对象搭配性能监控工具

内容对象是脚本与 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");

另请参阅

撰写性能监控工具的脚本

活动脚本性能监控工具范例