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

N/A

Description

Data Type: string

Access Type: Read Only

N/A

Destination

Data Type: string

Access Type: Read Write

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

InstallDate

Data Type: datetime

Access Type: Read Only

N/A

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

N/A

NextHop

Data Type: string

Access Type: Read Write

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

Status

Data Type: string

Access Type: Read Only

N/A

---

メソッド リスト

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

---

WQL サンプル (e.g. VB/C#/PowerShell)

SELECT * FROM Win32_IP4PersistedRouteTable

VB6/VBS
SWbemServices クラスの ExecQuery メソッドから WQL を実行可能です。
Set oClassSet = Service.ExecQuery("SELECT * FROM Win32_IP4PersistedRouteTable")
または下記のような記述でも実行可能です。
Set oClassSet = GetObject("winmgmts:\\.\root\cimv2").ExecQuery("SELECT * FROM Win32_IP4PersistedRouteTable")

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

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

PowerShell
Get-WmiObject コマンドレットの query オプションを指定し WQL を実行可能です。
Get-WmiObject -query "SELECT * FROM Win32_IP4PersistedRouteTable"
またはクラス名を直接指定する実行方法もあります。
Get-WmiObject Win32_IP4PersistedRouteTable

---

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

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

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

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

---