百分号标识的变量

添加下表中的任何百分号标识的变量，即可将操作的信息自定义。

<注> 请避免在脚本文字（活动脚本操作）中使用百分号标识的变量，否则解析后可能成为包含特殊字符的文字（单引号 ' '、双引号 " "、百分比 %、换行字符......等等），使脚本无效。

<重要事项> 主动监控工具变量只在操作直接对应到主动监控工具（而非整台设备）时才用得到。

<重要事项> 在 PowerShell 脚本中将百分号标识的变量当成字符串文字时，请以双引号 (" ") 包住字符串文字，不要使用单引号 (' ')。例如，$Message = "%Device.DisplayName changed state"。

主动监控工具变量

说明

%ActiveMonitor.Argument

SNMP 实例编号。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

%ActiveMonitor.Comment

网络交换机对应的易懂名称。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

%ActiveMonitor.Name

 

触发操作的主动监控工具名称。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

%ActiveMonitor.NetworkInterfaceAddress

网络接口的 IP 地址。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

%ActiveMonitor.Payload

WMI、Exchange、SQL、SNMP 或活动脚本主动监控工具返回的承载数据。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

活动脚本主动监控工具的承载数据，就是以脚本传递到 SetResult() 方法的文本。

%ActiveMonitor.State

 

监控工具当前的状态，例如“脱机至少 5 分钟”。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

设备变量

说明

%Device.ActiveMonitorDownNames

使用缩写名称的脱机服务列表 (若有)。

%Device.ActiveMonitorUpNames

设备所有上线服务 (接受监控) 的完整服务名称。

%Device.Address

IP 地址 (来自设备属性)。

%Device.Attribute.[属性名称]

返回取自设备的 SNMP 信息属性，例如联络人姓名。若要指定属性，请将类别名称（如下所列）加到变量后面。例如，%Device.Attribute.Contact，返回联络人姓名。

预设类别：

· *：返回所有属性

· Info1：从 v8 升级的方式

· Info2：从 v8 升级的方式

· 联络人：SNMP 的联络人信息

· 地点：SNMP 的位置信息

· 说明：SNMP 的说明信息

·自定义：若您已建立自定义属性，则可使用百分号标识的变量格式的自定义属性名称。

范例：

%Device.Attribute.Phone
%Device.Attribute.RackPosition

为避免错误，请务必在属性名称后面加上空格或换行符号。 

%Device.DatabaseID

返回设备的数据库 ID。

%Device.DisplayName

显示名称 (来自设备属性的 [一般] 字段)

%Device.HostName

主机名 (来自设备属性的 [一般] 字段)

%Device.Notes

注意事项：(来自设备属性 [注意事项] 字段的注意事项)。

%Device.SNMPOid

SNMP 对象标识符。

%Device.State

状态说明（例如“脱机至少 2 分钟”或“上线至少 5 分钟”）

%Device.Status

显示主动监控工具的名称，接在设备状态标识符后面：范例，10|DNS.

设备状态标识符值可涵盖：

0 = 未启动、1 = 暂停、2 = 已取消、3 = 执行中、4 = 完成、5 = 解析主机名、6 = 寻找类型、
7 = 扫描寻找 SNMP 认证、8 = 扫描寻找 Windows 认证、9 = 设备详细数据扫描、10 = 扫描自定义监控工具、12 = 扫描自定义监控工具、13 = 扫描设备 VMWare 主机、14 = 扫描SSH 认证、
15 = 第 2 层扫描、16 = 计算第 2 层网络架构、17 = 扫描无线网络、18 = 扫描网络接口、
19 = 检查有无重复设备、21 = 扫描寻找已知地址

%Device.Type

设备类型（来自设备属性的 [一般] 字段）

被动监控工具变量

说明

%PassiveMonitor.DisplayName

“被动监控工具库”中显示的监控工具名称。

%PassiveMonitor.LoggedText

详细事件说明（SNMP traps：返回完整 SNMP trap 文本）（Windows 记录文件项目：返回 Windows 事件记录文件项目内的信息。）（Syslog 项目：返回 Syslog 消息内的文本。）

%PassiveMonitor.Payload.*

被动监控工具生成的承载数据。

%PassiveMonitor.Payload.EventType

被动监控工具类型 (Syslog、Windows 事件或 SNMP Trap)

%PassiveMonitor.Payload.LogicalSource

显示设备的逻辑 IP 地址。

%PassiveMonitor.Payload.PhysicalSource

显示设备的实体 IP 地址。

系统变量

说明

%System.Date

目前的系统日期。配置 [地区选项] 中的日期格式 (在 [程序选项] 中)

%System.DisplayNamesDownDevices

监控工具脱机的设备显示名称

%System.DisplayNamesDownMonitors

 

显示设备名称及该设备所有脱机监控工具的名称。回应格式为 '设备名称':'监控工具 1','监控工具 2','...'

范例：ARNOR:FTP, HTTPS, Ping

%System.DisplayNamesUpDevices

上线设备的显示名称

%System.DisplayNamesUpMonitors

显示设备名称及该设备所有上线监控工具的名称。回应格式为 '设备名称':'监控工具 1','监控工具 2','...'

范例：ARNOR:FTP, HTTPS, Ping

%System.InstallDir

显示 WhatsUp Gold 的安装目录

%System.NumberofDownDevices

网络中的脱机设备数目

%System.NumberOfDownMonitors

显示网络中脱机监控工具的数目

%System.NumberofUpDevices

网络中的上线设备数目

%System.NumberOfUpMonitors

显示网络中上线监控工具的数目

%System.Time

目前的系统 时间。格式为 hh:mm:ss

另请参阅

关于百分号标识的变量