将上下文对象与性能监控器配合使用

上下文对象是脚本与 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");