MSFT_NetRoute 類別
代表 TCP/IP （因特網通訊協定套件） WMIv2 提供者的 IP 路由。
下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。
語法
[UMLPackagePath("CIM::Network::Routes"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetRoute : CIM_NextHopRoute
{
string Caption;
string Description;
string ElementName;
string InstanceID;
string DestinationAddress;
uint16 AdminDistance;
uint16 RouteMetric;
boolean IsStatic;
uint16 TypeOfRoute = 3;
string DestinationPrefix;
uint32 InterfaceIndex;
string InterfaceAlias;
string NextHop;
uint8 Publish;
datetime ValidLifetime;
datetime PreferredLifetime;
uint8 Store;
uint16 AddressFamily;
uint16 Protocol;
};
成員
MSFT_NetRoute類別具有下列類型的成員：
方法
MSFT_NetRoute 類別具有這些方法。
| 方法 | 描述 |
|---|---|
| 建立 | 建立IP路由。 |
| Find | 擷取指定遠端位址的IP路由。 |
屬性
MSFT_NetRoute 類別具有這些屬性。
-
AddressFamily
-
-
數據類型： uint16
-
存取類型：唯讀
取得值，指出路由是否使用 IPv4 或 IPv6 位址系列。 這個屬性會取得下列其中一個值。
-
IPv4 （2）
-
IPv6 （23）
-
-
管理員 Distance
-
-
數據類型： uint16
-
存取類型：唯讀
此路由的特定系統管理距離，覆寫系統或路由服務所指定的任何預設距離。
此屬性繼承自 CIM_NextHopRoute。
-
-
標題
-
-
數據類型： 字串
-
存取類型：唯讀
-
限定符： MaxLen （64）
包含物件的簡短文字描述。
此屬性繼承自 CIM_ManagedElement。
-
-
說明
-
-
數據類型： 字串
-
存取類型：唯讀
提供物件的文字描述。
此屬性繼承自 CIM_ManagedElement。
-
-
DestinationAddress
-
-
數據類型： 字串
-
存取類型：唯讀
做為要到達目的地的位址。
此屬性繼承自 CIM_NextHopRoute。
-
-
DestinationPrefix
-
-
數據類型： 字串
-
存取類型：唯讀
取得路由的目的地前置詞。
-
-
ElementName
-
-
數據類型： 字串
-
存取類型：唯讀
包含物件的使用者易記名稱。 這個屬性可讓每個實例除了定義其索引鍵屬性、身分識別數據和描述資訊之外，還定義使用者易記的名稱。
此屬性繼承自 CIM_ManagedElement。
-
-
InstanceID
-
-
數據類型： 字串
-
存取類型：唯讀
-
限定符： 索引鍵
唯一且不透明地識別這個類別在包含命名空間的範圍內實例。
[!重要]為了確保命名空間內的唯一性，應該以下列模式建構 InstanceID 的值：
OrgID：LocalID
OrgID 必須包含由定義 InstanceID 之商業實體所擁有的著作權、商標或其他唯一名稱，或是由已辨識的全域授權單位指派的已註冊標識符。 這類似於 Schema 類別名稱的結構。 此外，為了確保 InstanceID 中的第一個冒號必須介於 OrgID 和LocalID 之間。 在那裡，OrgID 不得包含冒號 （'：'）。
LocalID 是由商業實體選擇，不應重新用來識別不同的基礎真實世界元素。
如果未使用上述模式，定義實體必須確保由此或這個命名空間的其他提供者所產生的任何 InstanceID 不會重複使用產生的 InstanceID。
針對分散式管理工作組 （DMTF） 定義的實例，模式必須與設定為 CIM 的 OrgID 搭配使用。
此屬性繼承自 CIM_NextHopRoute。
-
-
InterfaceAlias
-
-
數據類型： 字串
-
存取類型：唯讀
取得路由的介面別名。
-
-
InterfaceIndex
-
-
數據類型： uint32
-
存取類型：唯讀
取得路由的介面索引。
-
-
IsStatic
-
-
數據類型： 布爾值
-
存取類型：唯讀
TRUE 表示這是靜態路由，FALSE 表示動態學習的路由。
此屬性繼承自 CIM_NextHopRoute。
-
-
NextHop
-
-
數據類型： 字串
-
存取類型：唯讀
取得路由下一個躍點的位址。
-
-
PreferredLifetime
-
-
數據類型： datetime
-
存取類型：讀取/寫入
取得和設定路由存留期的慣用結束時間。 這個屬性的預設值是無限的。
-
-
通訊協定
-
-
數據類型： uint16
-
存取類型：唯讀
從中學習路由的通訊協定。
值 意義 - 其他
- 1
其他通訊協定 - 本機
- 2
本機路由 - NetMgmt
- 3
網路管理靜態路由協定 （NETMGMT） - Icmp
- 4
網際網路控制訊息通訊協定 (ICMP) - Egp
- 5
外部閘道通訊協定 （EGP） - Ggp
- 6
閘道對閘道通訊協定 （GGP） - 您好
- 7
Hellospeak 通訊協定 （HELLO） - 把
- 8
路由資訊通訊協定 (RIP) - 伊希斯
- 9
中繼系統到中繼系統 （IS-IS） - EsIs
- 10
端系統到中繼系統 （ES-IS） - Igrp
- 11
內部閘道路由協定 （IGRP） - Bbn
- 12
BBN 通訊協定 - Ospf
- 13
開啟最短路徑第一個 （OSPF） - Bgp
- 14
邊界閘道通訊協定 (BGP) - Idpr
- 15
網域間路由協定 （IDPR） - Eigrp
- 16
增強的內部閘道路由通訊協定 （EIGRP） - Dvmrp
- 17
距離向量多播路由通訊協定 （DVMRP） - Rpl
- 18
低功率和遺失網路的路由通訊協定 （RPL） - Dhcp
- 19
動態主機設定通訊協定 (DHCP) -
-
發行
-
-
數據類型： uint8
-
存取類型：讀取/寫入
取得和設定值，這個值表示如何公告路由。 此屬性的預設值為 0。
值 意義 - 否
- 0
請勿公告路由。 - Age
- 1
公告特定間隔的路由。 - 是
- 2
無限期地公告路由。 -
-
RouteMetric
-
-
數據類型： uint16
-
存取類型：唯讀
相較於到達相同目的地的其他路由，提供此路由喜好設定的數值指示。
此屬性繼承自 CIM_NextHopRoute。
-
-
儲存
-
-
數據類型： uint8
-
存取類型：唯讀
取得值，這個值表示路由的狀態是否在重新啟動后持續存在。 這個屬性可以包含下列其中一個值。
值 意義 - 持續
- 0
重新啟動之後，路由的狀態會持續存在。 - 使用中
- 1
重新啟動後路由的狀態不會保存。 -
-
TypeOfRoute
-
-
數據類型： uint16
-
存取類型：唯讀
表示路由的類型。
此屬性繼承自 CIM_NextHopRoute。
-
管理員 istrator 定義路由 （2）
-
計算路由 （3）
-
實際路線 （4）
-
-
ValidLifetime
-
-
數據類型： datetime
-
存取類型：讀取/寫入
取得和設定路由存留期的有效結束時間。 這個屬性的預設值是無限的。
-
需求
| 最低支援的用戶端 |
Windows 8 |
| 最低支援的伺服器 |
Windows Server 2012 |
| Namespace |
Root\StandardCimv2 |
| MOF |
|
| DLL |
|