PowerShell

先決條件

WhatsUp Gold 使用 32 位元（亦即「x86」）PowerShell 引擎，只支援 32 位元的 PowerShell 嵌入式管理單元，而 64 位元的嵌入式管理單元無法正常運作。如果是能同時用於 32 位元和 64 位元作業系統的嵌入式管理單元，依預設是設定用於 64 位元系統，因此若要在 WhatsUp Gold 中發揮正常功能，必須針對 32 位元的 PowerShell 軟體引擎進行手動設定。

遠端連線要求：

在使用 PowerShell 來將 WhatsUp Gold 機器連線到目的地（輪詢的）裝置前，請先確認以下的設定皆已完備。

• Windows 認證：必須按照內容物件所提供的方法和屬性來明確使用認證。必須使用 HTTPS 來傳輸或者輪詢的裝置必須列在運行 WhatsUp Gold 的機器的 TrustedHosts 清單中。
• 網域和主機名稱：如果您使用使用者的預設認證。要單獨使用 IP 位址，您必須指定 PowerShell/WinRM 登入的認證。（如需詳細資訊，請參閱此 WinRM 故障排除說明。）
• 啟用 PowerShell 遠端：在目的地（輪詢的）裝置上啟用 PowerShell 遠端。如需詳細資訊，請參閱所提供的 MSDN 說明文件連結。

監控工具組態

此主動監控工具的組態欄位包括：

• 名稱：輸入主動監控工具的專屬名稱。此名稱會顯示在「監控工具資料庫」中。
• 說明：（選用）輸入監控工具的其他相關資訊。這段說明會顯示在「監控工具資料庫」中監控工具名稱的旁邊。
• 逾時（秒）：輸入 WhatsUp Gold 嘗試連線到所選裝置的容許時間長度。
• 以裝置認證執行：啟用這個核取方塊就能利用裝置的 Windows 認證執行指令碼。
• 指令碼文字：輸入您的主動監控工具程式碼。

可用的監控物件與屬性

PowerShell 主動監控工具指令碼提供兩個實體化的工作階段物件。

• 內容：IScriptContext 介面實作。這個物件讓您取得執行階段變數，也提供將結果傳回用戶端的機制。以下列出幾個實用的方法：
  • object GetProperty(string propertyName)：可根據名稱擷取環境變數值。
  • object SetProperty(string propertyName, string propertyValue)：可根據名稱指定環境變數值。
  • void SetResult(int resultCode, ResultsString)：讓指令碼能設定代表執行成敗的值，通常 0 = 成功，1 = 失敗。
• Logger：ILog 介面實作。此物件提供 C# 應用程式可使用的相同方法。以下列出幾個實用的方法：
  • void Error(string message)：建立特定錯誤的記錄項目，並包含訊息。
  • void Information(string message)：建立特定資訊的記錄項目，並包含訊息。
  • void WriteLine(string message)：建立一般性的記錄項目，並包含訊息。

取得或設定內容物件的屬性

您可以使用 PowerShell 主動監控工具指令碼來擷取內容屬性的值。

語法

Property-Value = Context.GetProperty("Property-Name")

Context.SetProperty(" Property-Name "," Property-Value ")

範例

$DeviceIpAddress = $Context.GetProperty("Address")

$Context.SetProperty("Timeout", "180")

設定結果字串及監控工具狀態指標

您所設定的結果字串將會被加入監控工具的狀態變更說明中。您所設定的狀態旗標（0、1）上線/離線會決定顯示在狀態變更時間軸中的指標。

# 在成功取得裝置 IP 後，設定為結果及成功旗標 ...

$Context.SetResult(0, "Device IP address is: " + $DeviceIpAddress)

內容物件屬性

以下的屬性可從建立的連線物件存取（在執行 PowerShell 主動監控工具指令碼語法範例時）。

內容物件認證屬性

可為 PowerShell 主動監控工具指令碼語法範例 設定以下的認證屬性。當在使用主動監控工具建立初始 PowerShell 連線之後，如需要再連線到其他服務、平台或應用程式時，這項功能就非常實用。

範例：檢查服務是否正在執行

建立一個只有當 DNS 用戶端使用儲存的認證來執行時才顯示上線狀態的 PowerShell 主動監控工具。

# 要輪詢的裝置

$DeviceIpAddress = $Context.GetProperty("Address")

# 直接設定電腦名稱，或者...

# $CompName = mydb02.corpnet.example.com (for example)

# ...使用 WMI 來取得...

$WmiRes = Invoke-Command -ComputerName $DeviceIpAddress -ScriptBlock { Get-WmiObject Win32_Computersystem }

$CompName = $WMIRes.PSComputerName

# 在遠端裝置上執行命令

$PsResult = Invoke-Command -ComputerName $DeviceName -ScriptBlock { Get-Service | where { $_.Name -match "Dnscache" } }

# 檢查「執行中」的條件

if ($PsResult.Status -match 'Running') {

$RespondingMessage = "Process '" + $processName + "' running on " + $DeviceIpAddress + " is responding."

$Context.SetResult(0, $RespondingMessage )

} else {

$NotRunningMessage = "Process '" + $processName + "' running on " + $DeviceIpAddress + " is not responding."

$Context.SetResult(1, $NotRunningMessage )

}