使用內容物件搭配 PowerShell 主動監控工具

可用的監控物件與屬性

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 )

}