【テクニカル・上級編】【システム診断】WMI (Win32_NetworkAdapterConfiguration) を用いた「死んでいる」ネットワークアダプタの自動特定と修復 – VBScript (Visual Basic Scripting Edition)解析バイブル

スポンサーリンク
スポンサーリンク

ネットワークの静かなる死を検知せよ:WMIを極限まで制御するインフラ自動修復の極意

インフラストラクチャの管理において、最も恐ろしいのは「明らかなエラー」ではない。システムが稼働しているように見えて、実はネットワークの不整合によって「機能的に死んでいる」状態、すなわちサイレント・フェイラー(Silent Failure)である。

IPアドレスの枯渇、DHCPの応答停止、あるいはドライバレベルのハングアップ。これらは標準的な監視ツールでは「Up」と判定されることが多々ある。我々シニアエンジニアに求められるのは、OSの深淵――WMI (Windows Management Instrumentation) を介して、システムの「真の生存状態」を診断し、自律的に修復する能力だ。

本稿では、VBScriptとWMIを用いて、ネットワークアダプタの異常を特定し、修復を試みる高度なスクリプト設計の思想を、コードの細部に至るまで解剖していく。

1. WMIにおける「オブジェクトの重み」を理解する

VBScriptによるWMI操作は、単なるクエリの実行ではない。それは、COM(Component Object Model)インターフェースを介した、プロセス間通信の重厚な儀式である。

多くの開発者は、`For Each` ループの中で取得したオブジェクトを、スコープが切れるまで放置する。しかし、大規模な環境や、長時間稼働するエージェントスクリプトにおいて、これはメモリリークと、WMIリポジトリへのロックを引き起こす致命的な欠陥となる。

アーキテクトの鉄則:明示的解放

WMIオブジェクトは、使い終わったら即座に `Nothing` を代入して、参照カウントをゼロに落とさなければならない。これは「作法」ではなく、「生存戦略」である。

2. 実装:ネットワーク診断と自己修復エンジン

以下に、`Win32_NetworkAdapterConfiguration` を用いてIP設定の不備を検出し、必要に応じて `Win32_NetworkAdapter` を介してデバイスを再起動(再有効化)する、プロフェッショナル仕様のスクリプトを示す。

' ==============================================================================
' System Diagnosis & Self-Healing Script: Network Adapter
' Author: Legendary Chief Architect
' Description: 
'   WMIを使用してIP設定が不完全なアダプタを特定し、
'   デバイスの再有効化を試みる。
' ==============================================================================

Option Explicit

' --- Constants ---
Const WQL_ADAPTER_CONFIG = "SELECT * FROM Win32_NetworkAdapterConfiguration WHERE IPEnabled = False OR IPAddress IS NULL"
Const WQL_ADAPTER_DEVICE = "SELECT * FROM Win32_NetworkAdapter WHERE NetConnectionID = '%s'"

' --- Main Execution ---
Main

Sub Main()
    Dim objWMIService, colAdapters, objAdapterConfig
    Dim strComputer, strError
    
    strComputer = "." ' Local Machine
    
    On Error Resume Next
    ' WMIサービスの接続。ImpersonationLevelはimpersonateを指定し、
    ' 実行コンテキストの権限を適切に委譲する。
    Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
    
    If Err.Number <> 0 Then
        WScript.Echo "CRITICAL: WMI connection failed. Error: " & Err.Description
        WScript.Quit 1
    End If
    On Error GoTo 0

    WScript.Echo "--- Starting Network Diagnosis ---"

    ' 1. IP設定が「死んでいる」アダプタの抽出
    Set colAdapters = objWMIService.ExecQuery(WQL_ADAPTER_CONFIG)

    If colAdapters.Count = 0 Then
        WScript.Echo "Status: All network configurations are healthy."
    Else
        For Each objAdapterConfig In colAdapters
            WScript.Echo "Detected Malfunctioning Adapter: " & objAdapterConfig.Description
            
            ' 2. 修復プロセスへの移行
            AttemptRepair objWMIService, objAdapterConfig.Description
            
            ' 【極限の知見】オブジェクトの明示的解放
            ' ループ内でのメモリリークを徹底的に防ぐ
            Set objAdapterConfig = Nothing
        Next
    End If

    ' クリーンアップ
    Set colAdapters = Nothing
    Set objWMIService = Nothing
    WScript.Echo "--- Diagnosis Complete ---"
End Sub

' ------------------------------------------------------------------------------
' AttemptRepair: 特定されたアダプタの修復を試みる
' ------------------------------------------------------------------------------
Sub AttemptRepair(objWMIService, strDescription)
    Dim colDevices, objDevice, intReturn, strQuery
    
    ' Win32_NetworkAdapterConfiguration は「設定」を扱うが、
    ' デバイス自体の有効化・無効化には Win32_NetworkAdapter が必要である。
    ' ここで、Descriptionをキーにしてデバイスを特定する。
    
    ' 注意: Descriptionは一意ではない可能性があるが、実務上は有力な識別子となる
    ' より厳密には、DeviceIDやIndexを使用すべきである。
    strQuery = "SELECT * FROM Win32_NetworkAdapter WHERE Description = '" & Replace(strDescription, "'", "''") & "'"
    
    Set colDevices = objWMIService.ExecQuery(strQuery)
    
    If colDevices.Count = 0 Then
        WScript.Echo "  [Error] Could not find corresponding hardware device for: " & strDescription
        Set colDevices = Nothing
        Exit Sub
    End If

    For Each objDevice In colDevices
        WScript.Echo "  [Action] Attempting to reset device: " & objDevice.Name
        
        ' デバイスの再起動プロセス(Disable -> Enable)
        ' これにより、スタックの初期化とIPの再取得を強制する
        
        ' Disable
        intReturn = objDevice.Disable()
        If intReturn = 0 Then
            WScript.Echo "  [Success] Device disabled successfully."
            
            ' Enable
            intReturn = objDevice.Enable()
            If intReturn = 0 Then
                WScript.Echo "  [Success] Device re-enabled. DHCP/Static IP refresh triggered."
            Else
                WScript.Echo "  [Failed] Failed to enable device. HRESULT: " & intReturn
            End If
        Else
            WScript.Echo "  [Failed] Failed to disable device. HRESULT: " & intReturn
        End If
        
        Set objDevice = Nothing
    Next
    
    Set colDevices = Nothing
End Sub

3. 技術的深掘り:なぜこの設計なのか

WMIの二重構造を使い分ける

本スクリプトの肝は、`Win32_NetworkAdapterConfiguration` と `Win32_NetworkAdapter` の使い分けにある。

  • `Win32_NetworkAdapterConfiguration`: IP、サブネットマスク、DNSといった「論理的なプロトコルスタック」の状態を司る。
  • `Win32_NetworkAdapter`: 物理的なNIC、あるいは仮想NICの「ハードウェア的な状態(有効/無効)」を司る。

「IPが割り当たっていない」という問題に対し、設定だけを見直しても解決しないことが多い。デバイス自体を `Disable()` してから `Enable()` することで、OSに対してカーネルレベルでのドライバ再ロードと、ネットワークスタックの再初期化を強制させているのだ。これが、レガシー環境における最も確実な「物理的リセット」の手法である。

エラーハンドリングの哲学

`On Error Resume Next` を安易に乱用するのは素人のすることだ。本スクリプトでは、WMI接続という「失敗の可能性が極めて高い境界点」にのみ限定して適用し、それ以外のロジックでは戻り値(`intReturn`)によるチェックを行っている。
WMIのメソッド(`Enable()` など)は、例外をスローするのではなく、HRESULT(戻り値)を返す。これを無視することは、システムの沈黙を見逃すことと同義である。

パフォーマンスとメモリ管理

`Set obj = Nothing` をループの最後、あるいは処理の区切りに配置している点に注目してほしい。WMIオブジェクトは、COMの参照カウントが残っている限り、メモリ上に居座り続ける。大量のアダプタが存在するサーバーや、このスクリプトをタスクスケジューラで頻繁に実行する場合、この「一瞬の解放」がシステムの安定性を左右する。

4. 結論:自動化の先にあるもの

自動化エンジニアの真価は、コードの短さではなく、「例外的な状況下でもシステムを制御下に置き続ける堅牢性」に現れる。

今回提示した手法は、単なるネットワーク修復スクリプトではない。システムの「不整合」を検知し、物理層に近いレイヤーから再構成を試みる、インフラの自己治癒(Self-healing)のプロトタイプである。

レガシーなWindows環境が残る現場において、この知見は、深夜の呼び出しを減らし、システムの可用性を極限まで高めるための強力な武器となるだろう。

タイトルとURLをコピーしました