Pingを送信し応答結果を取得する: Win32_PingStatus - WMI Sample (VBS)

Topics

WMI経由でPingを送信してその応答結果を取得するサンプルプログラムです。Win32_PingStatusクラスを使用します。

従来のVB(VB6)版のサンプルコードはこちらで公開しています。

Sample Code

Option Explicit

'WMIにて使用する各種オブジェクトを定義・生成する。
Dim oClassSet
Dim oClass
Dim oLocator
Dim oService

'ローカルコンピュータに接続する。
Set oLocator = WScript.CreateObject("WbemScripting.SWbemLocator")
Set oService = oLocator.ConnectServer
'クエリー条件をWQLにて指定する。
Set oClassSet = oService.ExecQuery("Select * From Win32_PingStatus Where Address = '192.168.0.1'")

'コレクションを解析する。
For Each oClass In oClassSet

Select Case oClass.StatusCode
Case 0
MsgBox "Success"
Case 11010
MsgBox "Request Timed Out"
Case Else
MsgBox "その他のエラー"
End Select

Next

'使用した各種オブジェクトを後片付けする。
Set oClassSet = Nothing
Set oClass = Nothing
Set oService = Nothing
Set oLocator = Nothing

Comment

実行すると指定したIPアドレスに対してPingを送信してその応答結果を表示します。「Success」と表示されれば成功です。「Request Timed Out」と表示されれば基本的にはPing失敗ということです。
StatusCodeプロパティを参照すればPingを打った結果の戻り値を取得できます。このStatusCodeプロパティを参照した戻り値の詳細は以下の通りです。

0 : Success
11001 : Buffer Too Small
11002 : Destination Net Unreachable
11003 : Destination Host Unreachable
11004 : Destination Protocol Unreachable
11005 : Destination Port Unreachable
11006 : No Resources
11007 : Bad Option
11008 : Hardware Error
11009 : Packet Too Big
11010 : Request Timed Out
11011 : Bad Request
11012 : Bad Route
11013 : TimeToLive Expired Transit
11014 : TimeToLive Expired Reassembly
11015 : Parameter Problem
11016 : Source Quench
11017 : Option Too Big
11018 : Bad Destination
11032 : Negotiating IPSEC
11050 : General Failure

エラーステータスとしてはコマンドプロンプトベースのPingコマンドと同じような感覚で細かく取れそうなので結構使えるかもしれません。
社内などでサーバーの生存確認目的でWin32_PingStatusクラスを使用して、Pingベースのサーバー管理用スクリプト/Keep aliveチェックスクリプトを作ってみたり、
すべてのルーターへ定期的にPingを実行しレスポンス状況からネットワーク監視ツールを作ってみるのも楽しいかもしれませんし、かなり便利に使えるWMIクラスだと思います。

ちなみにこのWin32_PingStatusクラスはWindows XP/Windows Server 2003以降の環境でなければ使用できません。ご注意下さい。

Win32_PingStatus クラスに関連するサンプルコードは他に、

を紹介しています。
なおWMIの使い方(VB6, VBS, VBA, VB.NET, VC#, PowerShellを対象)に関してはWMI Stepも参考にしてみてください。(WMI初心者・入門編としてもおすすめです。) 各種言語を使用したWMIを使用するたたき台としてソースコードテンプレートも公開しています。WMIプログラム/スクリプト作成時に役立てば…と思っています。

Recommended book

個人的にお勧めする本の紹介です。

Latest sample information

最近WMI Sampleへ追加したサンプルのご紹介です。

興味のあるサンプル・クラスがありましたら参考にしてみて下さい。