百分比變數

加入下表中的任何百分比變數，即可將動作的訊息客製化。

<請注意> 請避免在指令碼文字（動態指令碼動作）中使用百分比變數，否則解析後可能成為包含特殊字元的文字（單引號 ' '、雙引號 " "、百分比 %、換行字元……等等），使指令碼無效。

<重要事項> 主動監控工具變數只在動作直接對應到主動監控工具（而非整台設備）時才用得到。

<重要事項> 在 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 Trap：傳回完整的 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

另請參閱

關於百分比變數