Win32_IP4PersistedRouteTable クラス - WMI Library

Win32_IP4PersistedRouteTable クラスの説明

IP4PersistedRouteTable クラスは持続される IP ルートを含みます。既定では、ルーティング テーブルに追加するルートは永久的ではありません。コンピューターを再起動するときにこれらのルートは失われます。ただし、コマンド route -p add を使用すると、Windows NT により永久的になり、コンピューターを再起動するときにルートは失われません。コンピューターのルート テーブルが再構築されるごとに、固定エントリがルート テーブルに再挿入されます。Windows NT ではレジストりに固定ルートが格納されます。このクラスは特に IP4 を扱い、IPX または IP6 は扱いません。
WMI Providerは、RouteProviderです。
UUIDは、{2CAF4666-AC9B-45AB-00A6-AF8C537794C2}です。

---

プロパティ リスト

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 アドレスを含みます。

InstallDate

Data Type: datetime

Access Type: Read Only

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

Mask

Data Type: string

Access Type: Read Write

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

Metric1

Data Type: sint32

Access Type: Read Write

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

Name

Data Type: string

Access Type: Read Only

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

NextHop

Data Type: string

Access Type: Read Write

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

Status

Data Type: string

Access Type: Read Only

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

---

メソッド リスト

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

---

WQL サンプル

SELECT * FROM Win32_IP4PersistedRouteTable

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

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

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

---

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

このコンテンツはWMIの各コンポーネントが持っているWin32_IP4PersistedRouteTableクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照した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

---