PowerShell アクティブモニタでのコンテキストオブジェクトの使用

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

PowerShell アクティブモニタスクリプトでは、2 つのインスタンス化セッションオブジェクトを利用できます。

• [コンテキスト]。IScriptContext インターフェイスの実装。このオブジェクトを使用するとランタイム変数にアクセスでき、結果をクライアントに返すメカニズムも提供します。便利なメソッドの一部を以下に示します。
  • object GetProperty(string propertyName) - コンテキスト変数値を名前で取得できます。
  • object SetProperty (string propertyName, string propertyValue ) - コンテキスト変数値を名前で指定できます。
  • void SetResult(int resultCode, ResultsString) - 成功を示す値をスクリプトで設定できます。通常、0 は成功、1 は失敗です。
• ロガー。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 アクティブモニタを作成します。

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

}