Win32_IP4RouteTable クラス - WMI Library

Win32_IP4RouteTable クラスの説明

IP4RouteTable クラス情報はネットワーク データ パケットがルートされる場所を指定します (たとえば、通常インターネット パケットはゲートウェイに送信され、ローカル パケットはクライアント コンピューターによって直接にルートされる可能性があります。)。管理者はこの情報を使用して、間違ってルートされたパケットに関連する問題を追跡したり、必要な場合にはコンピューターを新しいゲートウェイに経由させたりすることができます。このクラスは特に IP4 を扱い、IPX または IP6 は扱いません。コマンド プロンプトで 'Route Print' コマンドを入力するときに現れる情報をモデル化するためにのみ設計されています。
注: このクラスの更新インスタンスはサポートされていますが、無効であるか、ネットワーク プロトコル スタックにより認識されていない提供プロパティ値は正しく更新されずに、元の値が残ります。これが起こるときにエラーが生成される保証はありませんが、その場合は何も更新されません。
WMI Providerは、RouteProviderです。
UUIDは、{ABEE8C61-A43F-4088-0081-9D00B3FF6545}です。

---

プロパティ リスト

Age

Data Type: uint32

Access Type: Read Only

Age プロパティは、このルートが最後に更新されてからか、またはそうでない場合は修正すると判定されてからの秒数を含みます。'too old' の語義は、ルートを学習するルーティング プロトコルの知識を除いては含まれません。

Caption

Data Type: string

Access Type: Read Only

Caption プロパティは、オブジェクトを短いテキスト (1 行の文字列) で表した説明です。

Description

Data Type: string

Access Type: Read Only

Description プロパティは、オブジェクトの説明を提供します。

Destination

Data Type: string

Access Type: Read Write

Destination プロパティはこのルートの宛先 IP アドレスを含みます。

Information

Data Type: string

Access Type: Read Only

Information プロパティは、ルートの ipRouteProto 値に指定される値によって決定され、このルートに関係する特定のルーティング プロトコルに固有の MIB 定義に対する参照を含みます。この情報がない場合は、その値は構文的に有効なオブジェクト識別子である OBJECT IDENTIFIER {0 0} に設定される必要があり、ASN.1 および BER の適合する実装がこの値を生成および認識できる必要があります。

InstallDate

Data Type: datetime

Access Type: Read Only

InstallDate プロパティは、オブジェクトがいつインストールされたかを示す datetime 値です。値がなくても、オブジェクトがインストールされていないことを示すわけではありません。

InterfaceIndex

Data Type: sint32

Access Type: Read Write

InterfaceIndex プロパティは、到達される必要があるこのルートの次のホップをとおしてローカル インターフェイスを一意に識別するインデックス値を含みます。

Mask

Data Type: string

Access Type: Read Write

Mask プロパティはこのエントリで使用されるマスクを含みます。マスクは ipRouteDest フィールドの値と比較される前に、宛先アドレスで論理 AND される必要あります。

Metric1

Data Type: sint32

Access Type: Read Write

Metric1 プロパティは、このルートのプライマリ ルーティング メトリックを含みます。このメトリックの語義はルートの ipRouteProto 値に指定されるルーティング プロトコルによって決定されます。このメトリックが使用されない場合は、値は -1 に設定される必要があります。

Metric2

Data Type: sint32

Access Type: Read Write

Metric2 プロパティは、このルートの代替ルーティング メトリックを含みます。このメトリックの語義はルートの ipRouteProto 値に指定されるルーティング プロトコルによって決定されます。このメトリックが使用されない場合は、値は -1 に設定される必要があります。

Metric3

Data Type: sint32

Access Type: Read Write

Metric3 プロパティは、このルートの代替ルーティング メトリックを含みます。このメトリックの語義はルートの ipRouteProto 値に指定されるルーティング プロトコルによって決定されます。このメトリックが使用されない場合は、値は -1 に設定される必要があります。

Metric4

Data Type: sint32

Access Type: Read Write

Metric4 プロパティは、このルートの代替ルーティング メトリックを含みます。このメトリックの語義はルートの ipRouteProto 値に指定されるルーティング プロトコルによって決定されます。このメトリックが使用されない場合は、値は -1 に設定される必要があります。

Metric5

Data Type: sint32

Access Type: Read Write

Metric5 プロパティは、このルートの代替ルーティング メトリックを含みます。このメトリックの語義はルートの ipRouteProto 値に指定されるルーティング プロトコルによって決定されます。このメトリックが使用されない場合は、値は -1 に設定される必要があります。

Name

Data Type: string

Access Type: Read Only

Name プロパティは、オブジェクトを認識するためのラベルを定義します。サブクラスでは、Name プロパティは上書きされて Key プロパティになることがあります。

NextHop

Data Type: string

Access Type: Read Write

NextHop プロパティはこのルートの次のホップの IP アドレスを含みます。(ブロードキャスト メディア経由で認識されるインターフェイスにバインドされるルートの場合は、このフィールドの値はインターフェイス上のエージェントの IP アドレスです。)

Protocol

Data Type: uint32

Access Type: Read Only

Protocol プロパティはこのルートを学習するルーティング機構を示します。ゲートウェイ ルーティング プロトコルに値を含めるのは、ホストがそれらのプロトコルをサポートする必要があるということではありません。

Status

Data Type: string

Access Type: Read Only

Status プロパティはオブジェクトの現在の状態を示す文字列です。操作可能な状態および操作不可能な状態が定義されます。操作可能な状態は、"OK"、"低下" および "障害が発生する可能性あり" です。"障害が発生する可能性あり" は、要素は適切に機能するけれども近いうちに障害が発生する可能性があることを示します。例: SMART 対応ハード ディスク。操作不可能な状態も指定できます。これは、"エラー"、"開始中"、"停止動作中" および "サービス" です。最後の "サービス" には、ディスクがミラーされている間、ユーザーのアクセス許可の一覧を再度読み込む間、または他の管理用作業が行われている間などが該当します。この作業がすべてオンラインで行われるとは限りませんが、[管理要素] は "OK" でも他の状態でもありません。

Type

Data Type: uint32

Access Type: Read Write

Type プロパティはルートの種類を示します。値 direct(3) および indirect(4) は IP アーキテクチャの直接ルーティングと間接ルーティングの表記を参照します。このオブジェクトを値 invalid(2) に設定すると、RouteTable オブジェクトの対応するエントリを無効にする効果があります。これは効率的に said エントリで識別される宛先と said エントリで識別されるルートの関連付けを解除します。エージェントがテーブルから無効になっているエントリを削除するかどうかは実装固有の問題です。これに応じて、現在使用されていないエントリに対応するエージェントからの表形式の情報を受信するように管理ステーションを準備する必要があります。このようなエントリの適切な解釈には、関連する ipRouteType オブジェクトの検査が必要です。

---

メソッド リスト

Win32_IP4RouteTableクラスにはメソッドはありません。

---

WQL サンプル

SELECT * FROM Win32_IP4RouteTable

VB6/VBS
SWbemServicesクラスのExecQueryメソッドからWQLを実行可能です。
Set PrcSet = Service.ExecQuery("SELECT * FROM Win32_IP4RouteTable")

VB.Net
ObjectQueryクラスのQueryStringプロパティにWQLを設定し、ManagementObjectSearcherクラスのGetメソッドからWQLを実行可能です。
Searcher.Query.QueryString = "SELECT * FROM Win32_IP4RouteTable"
PrcSrc = Searcher.Get

PowerShell
Get-WmiObjectコマンドレットのqueryオプションを指定しWQLを実行可能です。
Get-WmiObject -query "SELECT * FROM Win32_IP4RouteTable"

---

このサイトの情報について

このコンテンツはWMIの各コンポーネントが持っているWin32_IP4RouteTableクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照したWMIの名前空間はroot/CIMV2、書き出し環境はWindows Server 2008 R2になります。

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

今後各WMI ClassをサポートしているOSの種類を掲載する予定です。
予定OS: Windows XP/Windows Vista/Windows 7/Windows Server 2003/Windows Server 2003 R2/Windows Server 2008/Windows Server 2008 R2

---