将上下文对象与 PowerShell 主动监控工具搭配使用

可用监控工具对象和属性

PowerShell 主动监控工具脚本提供两个实体化的会话对象。

• 上下文。IScriptContext 界面的实作。这个对象让您取得运行时间变量，也提供将结果返回客户端的机制。以下列出几个实用的方法：
  • object GetProperty(string propertyName)：可根据名称检索环境变量值。
  • object SetProperty (string propertyName, string propertyValue)：可根据名称规定环境变量值。
  • void SetResult(int resultCode, ResultsString)：让脚本能设定代表成功的值，通常 0 = 成功，1 = 失败。
• 记录程序：ILog 界面的实作。此对象提供 C# 应用程序可使用的相同方法。以下列出几个实用的方法：
  • void Error(字符串信息)：建立特定错误的记录项目，并包含信息。
  • void Information(字符串信息)：建立特定信息的记录项目，并包含信息。
  • void WriteLine(字符串信息)：建立一般性的记录项目，并包含信息。

获取或设置上下文对象的属性。

您可以通过 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（举例）

# ...用 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 )

}