您可以使用百分号变量，对操作的消息和特定配置内容进行自定义。

注： 如需 WhatsUp Gold 警报中心特定变量的表格，请参阅 警报中心百分号变量 。

使用百分号变量的重要指南

  • WhatsUp Gold 中的所有百分号变量均需区分大小写。
  • 不支持也不建议在百分号变量中使用空格。
  • 百分号变量在脚本文本中的使用（例如 活动脚本操作 ）可扩展至包含特殊字符的文本。例如 '、"、%、[新行]。在非转义情况下，这些文字可能导致意外的语法或解析错误，损坏您的脚本。
  • 主动监控工具变量只在操作直接对应到主动监控工具（而非整台设备）时才用得到。
  • 在 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.ActiveMonitorDownNamesCSV

脱机主动监控工具名称列表，由逗号分隔。

%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.Role

设备属性界面中显示的主要设备角色。

%Device.RoleGUID

分配给设备的主要角色的全局唯一标识符。

%Device.SNMPOid

SNMP 对象标识符。

%Device.State

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

%Device.BestState

设备状态描述，包含设备的“最佳”状态。例如，如果由于监控工具失败，设备从未处于联机状态，最佳状态可能是脱机。

%Device.WorstState

设备状态描述，包含设备的“最差”状态。例如，如果由于监控工具失败，设备从未处于脱机状态，最差状态可能是联机。

%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.ManualMaintenanceReason

自定义您填充的字符串，并提供将设备置于维护状态的原因。

%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

显示系统日期（使用与运行 WhatsUp Gold 服务器的操作系统相同的格式）。

%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