PowerShell スクリプト
- Last Updated: October 16, 2024
- 7 minute read
PowerShell スクリプトを使用すると、Windows PowerShell を使用してカスタムパフォーマンスモニタを作成できます。
重要:
WhatsUp Gold では 32 ビット (すなわち x86) の PowerShell エンジンを使用します。したがって、32 ビットの PowerShell スナップインのみがサポートされており、64 ビットのみのスナップインは正しく機能しません。32 ビットと 64 ビットの両方のオペレーティングシステムで使用可能なスナップインは、デフォルトでは 64 ビットシステム用に設定されており、32 ビットの PowerShell エンジンが WhatsUp Gold で正常に機能するためには、手動で設定する必要があります。
PowerShell スクリプトパフォーマンスモニタには次の認証情報が必要です。
- Windows
次のボックスを使用して PowerShell スクリプトパフォーマンスモニタを設定します。
- [名前] 。パフォーマンスモニタの名前。この名前がモニタライブラリに表示されます。
- [説明] 。必要に応じて、モニタライブラリに列データとして表示するパフォーマンスモニタの説明。
- [タイムアウト] 。WhatsUp Gold が、選択したデバイスへの接続を試行する時間。これは接続失敗と見なされます。
-
[ポーリング間隔]
。WhatsUp がデバイスから更新情報を要求する頻度を指定します。注: タイムアウトに設定できる最大値は 60 秒ですが、10 秒を超えるタイムアウトの設定は推奨されません。タイムアウトは可能な限り短くすることをお勧めします。
-
[参照変数]
。SNMP 参照変数と WMI 参照変数を追加、編集、または削除します。SNMP または WMI のいずれかの PowerShell スクリプトパフォーマンスモニタを設定するには、以下の手順を参照してください。注: PowerShell パフォーマンスモニタでの参照変数の使用は必須ではありません。参照変数を使用する場合、参照変数をポーリングし、そのデータをグラフ表示するために、
Context.GetReferenceVariableを使用する必要があります。参照変数は、スクリプトアクションとスクリプトアクティブモニタのように、デバイスのプロパティのリストを使用する必要がないため、コードのスクリプト作成が簡略化され、スクリプトを効率的に記述できます。参照変数は、通常、リモートデバイス上の SNMP または WMI カウンタにアクセスするためにユーザーが制御する必要がある基盤の SNMP または WMI メカニズムを制御します。Context.GetReferenceVariable(変数名) を使用すれば、事前に定義された変数の名前を指定するだけで済みます。WhatsUp Gold はデバイスの認証情報を使用し、SNMP または WMI でターゲットデバイスに接続して、要求された情報を取得します。この情報は変数に保存され、今後スクリプトで使用できます。詳細については、「 パフォーマンスモニタでのコンテキストオブジェクトの使用 」を参照してください。 - デバイスに割り当てられた Windows 認証情報を使用して実行します 影響を受けるデバイスの Windows 認証情報を使用してスクリプトを実行する場合にこのオプションを有効にします。
-
[スクリプトテキスト]
。モニタコードを入力します。重要: 平均を計算するために 2 つのポーリングを必要とする WMI 参照変数をポーリングすると (「Processor\% Processor Time」など)、初回は「Null」が返されます。
SNMP PowerShell スクリプトパフォーマンスモニタを設定するには:
- 新しい変数を
[参照変数]
フィールドに追加するには、[Powershell スクリプトパフォーマンスモニタ]
ダイアログで
をクリックします。[新しい参照変数の追加] ダイアログが表示されます。 - 適切な情報を入力します。
- [変数名] 。変数の固有の名前を入力します。
- [説明] 。(省略可能) 変数の短い説明を入力します。
- [SNMP] ラジオボタンを選択します。
- デバイス接続の [タイムアウト] および [再試行回数] に値を入力します。これらのフィールドには必要に応じて入力します。
- [選択] をクリックして MIB ブラウザを起動します。
- [コンピュータからカウンタを選択する] ボックスに、接続するコンピュータの名前または IP アドレスを入力します。参照ボタン ( [...] ) をクリックしてリストからデバイスを選択できます。
- デバイス接続に使用する SNMP 認証情報 を選択します。参照ボタン ( [...] ) をクリックして認証情報ライブラリにアクセスし、新しい認証情報を作成することもできます。
- [タイムアウト] ボックスと [再試行回数] ボックスで、接続するコンピュータの接続試行時間と再試行回数を調整します。
- [OK] をクリックします。
- ナビゲーションツリーを使用して、監視する MIB を選択します。ダイアログの下部に、プロパティ/値の詳細情報が表示されます。
- [OK] をクリックして、[新しい参照変数の追加] ダイアログの [パフォーマンスカウンタ] および [インスタンス] フィールドに OID を追加します。
- 設定を確認し、 [OK] をクリックして [Powershell スクリプトパフォーマンスモニタ] ダイアログの [参照変数] リストに変数を追加します。
- [スクリプトテキスト] フィールドにモニタコードを記述するか、貼り付けます。
- [OK] をクリックして、変更を保存します。
WMI PowerShell スクリプトパフォーマンスモニタを設定するには:
- 新しい変数を
[参照変数]
フィールドに追加するには、[Powershell スクリプトパフォーマンスモニタ]
ダイアログで
をクリックします。[新しい参照変数の追加] ダイアログが表示されます。 - 適切な情報を入力します。
- [変数名] 。変数の固有の名前を入力します。
- [説明] 。(省略可能) 変数の短い説明を入力します。
- [WMI] ラジオボタンを選択します。
- [選択] をクリックして MIB ブラウザを起動します。
- [コンピュータからカウンタを選択する] ボックスに、接続するコンピュータの名前または IP アドレスを入力します。参照ボタン ( [...] ) をクリックしてリストからデバイスを選択できます。
- デバイスに接続するために使用する Windows 認証情報 を選択します。参照ボタン ( [...] ) をクリックして認証情報ライブラリにアクセスし、新しい認証情報を作成することもできます。
- [OK] をクリックします。
- ナビゲーションツリーを使用して、監視する MIB を選択します。ダイアログの下部に、プロパティ/値の詳細情報が表示されます。
- [OK] をクリックして、[新しい参照変数の追加] ダイアログの [パフォーマンスカウンタ] および [インスタンス] フィールドに OID を追加します。
- 設定を確認し、 [OK] をクリックして [Powershell スクリプトパフォーマンスモニタ] ダイアログの [参照変数] リストに変数を追加します。
- [スクリプトテキスト] フィールドにモニタコードを記述するか、貼り付けます。
- [OK] をクリックして、変更を保存します。