PowerShell アクションでのコンテキストオブジェクトの使用

使用可能なモニタのオブジェクトと属性

PowerShell アクションスクリプトでは、以下のインスタンス化セッションオブジェクトを利用できます。

• [コンテキスト]。IScriptContext インターフェイスの実装。このオブジェクトを使用するとランタイム変数にアクセスでき、プロパティを取得または設定し、監視環境を操作し、結果をクライアントに返すことができます。便利なメソッドの一部を以下に示します。
  • object GetProperty(string Property-Name) - コンテキスト変数値を名前で取得できます。
  • object SetProperty (string Property-Name, string Property-Value ) - コンテキスト変数値を名前で指定できます。
  • object LogMessage (string This is a log message.) - WhatsUp Gold ログにメッセージを記録します。
  • object GetDeviceProperty (string Device-Property-Name) - 監視対象デバイスに固有のプロパティ値を取得します。
  • object SetDeviceProperty (string Device-Property-Name, string Property-Value) - 監視対象デバイスに固有のプロパティ値を設定します。

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 アクティブモニタを作成します。

# Device to Poll

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

# Set the computer name directly, or...

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

# ...get it using WMI...

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

$CompName = $WMIRes.PSComputerName

# Run command on remote device

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

# Check for condition of 'running'

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 )

}