使用内容对象搭配操作

内容对象是脚本与 WhatsUp Gold 互动的接口。

您必须利用 Context 名称空间检索所有的方法和特性。

注释 从说明文件复制程序代码时若出现版权信息,最好移除贴上的版权信息。

方法

方法说明

LogMessage(sText);

此方法可将信息写入 WhatsUp Gold 侦错记录文件。 “事件查看器”会显示信息。

范例

JScript

Context.LogMessage( "使用 Context.GetProperty() 检查操作名称");

VBScript

Context.LogMessage "使用 Context.GetProperty() 检查地址"

SetResult(LONG nCode, sText);

此方法可让您设定结果代码和结果信息。您可以藉此让 WhatsUp Gold 系统得知操作是否成功。

范例

JScript

Context.SetResult(0, "脚本顺利完成。"); //Success
Context.SetResult(1, "出现错误。"); //Failure

VBScript

Context.SetResult 1, "出现错误。"

NotifyProgress(sText);

此方法可将信息写入操作进度对话框。[测试] 和 [执行中操作] 对话框会显示信息。

范例

JScript

Context.NotifyProgress( "使用 Context.GetProperty() 检查操作名称");

VBScript

Context.NotifyProgress "使用 Context.GetProperty() 检查地址"

IsCancelled();

此方法可测试用户是否已取消操作。若返回 true,脚本就应该终止。

用户可以在操作进度对话框中取消操作,或在关机时由 WhatsUp Gold 软件引擎取消操作。

GetProperty(sPropertyName);

此特性可让您访问设备的许多特定部分。您可利用列出的名称访问这些项目。这些名称有大小写之分。

"ActionName"

操作显示名称

"Address"

设备的 IP 地址

"Name"

设备的网络名称

"DisplayName"

设备的显示名称

"DeviceID"

设备 ID

"ActionTypeID"

操作类型 ID

"TriggerCondition"

触发操作的原因。

触发值:

 1 监控工具由脱机转为上线
 2 监控工具由上线转为脱机
 4 收到一个被动监控工具......
 8 按下 [测试] 按钮
16 这是周期性操作......
32 设备上线
64 Device is DOWN

"CredWindows:DomainAndUserid"

Windows NT 网域和用户 ID

只有在启用仿真功能时才能使用这个内容对象。

"CredWindows:Password"

Windows NT 密码

只有在启用仿真功能时才能使用这个内容对象。

范例

JScript

var sAddress = Context.GetProperty("Address");
var nDeviceID = Context.GetProperty("DeviceID");

另请参阅

撰写操作的脚本

活动脚本操作范例