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 路由。 |
| 查找 | 检索指定的远程地址的 IP 路由。 |
属性
MSFT_NetRoute 类具有以下属性。
-
AddressFamily
-
-
数据类型：uint16
-
访问类型：只读
获取一个值，该值指示路由是使用 IPv4 还是 IPv6 地址系列。 此属性获取下列值之一。
-
IPv4 (2)
-
IPv6 (23)
-
-
AdminDistance
-
-
数据类型：uint16
-
访问类型：只读
此路由的特定管理距离，替代系统或路由服务指定的任何默认距离。
此属性继承自 CIM_NextHopRoute。
-
-
Caption
-
包含对象的简短文本描述。
此属性继承自 CIM_ManagedElement。
-
描述
-
-
数据类型：字符串
-
访问类型：只读
提供对象的文本描述。
此属性继承自 CIM_ManagedElement。
-
-
DestinationAddress
-
-
数据类型：字符串
-
访问类型：只读
用作要到达目的地的地址。
此属性继承自 CIM_NextHopRoute。
-
-
DestinationPrefix
-
-
数据类型：字符串
-
访问类型：只读
获取路由的目标前缀。
-
-
ElementName
-
-
数据类型：字符串
-
访问类型：只读
包含对象的用户友好名称。 此属性允许每个实例除了定义其关键属性、标识数据和描述信息之外，还定义一个用户友好名称。
此属性继承自 CIM_ManagedElement。
-
-
InstanceID
-
-
数据类型：字符串
-
访问类型：只读
-
限定符：key
在包含命名空间的范围内唯一且不透明地标识此类的实例。
[重要提示！]为了确保命名空间中的唯一性，应使用以下模式构造 InstanceID 的值：
OrgID：LocalID
OrgID 必须包含由定义 InstanceID 的业务实体拥有的受版权保护、带商标或唯一名称，或者是由已识别的全局颁发机构分配的已注册 ID。 这类似于 Schema 类名的结构。 此外，为了确保 InstanceID 中的第一个冒号必须位于 OrgID 和 LocalID 之间。 OrgID 不得包含冒号 (':')。
LocalID 由业务实体选择，不应重复使用来标识不同的基础实际元素。
如果不使用前面的模式，则定义实体必须确保生成的 InstanceID 不会在此提供程序或其他提供程序为此命名空间生成的任何 InstanceID 中重复使用。
对于分布式管理任务组 (DMTF) 定义的实例，必须在 OrgID 设置为 CIM 的情况下使用该模式。
此属性继承自 CIM_NextHopRoute。
-
-
InterfaceAlias
-
-
数据类型：字符串
-
访问类型：只读
获取路由的接口别名。
-
-
InterfaceIndex
-
-
数据类型：uint32
-
访问类型：只读
获取路由的接口索引。
-
-
IsStatic
-
-
数据类型：布尔值
-
访问类型：只读
TRUE 表示这是静态路由，FALSE 标识动态学习的路由。
此属性继承自 CIM_NextHopRoute。
-
-
NextHop
-
-
数据类型：字符串
-
访问类型：只读
获取路由下一个跃点的地址。
-
-
PreferredLifetime
-
-
数据类型：datetime
-
访问类型：读/写
获取并设置路由生存期的首选结束时间。 此属性的默认值为无限期。
-
-
协议
-
-
数据类型：uint16
-
访问类型：只读
从中获知路由的协议。
值 含义 - 其他
- 1
其他协议 - 本地
- 2
本地路由 - NetMgmt
- 3
网络管理静态路由协议 (NETMGMT) - Icmp
- 4
Internet 控制消息协议 (ICMP) - Egp
- 5
外部网关协议 (EGP) - Ggp
- 6
网关到网关协议 (GGP) - Hello
- 7
Hellospeak 协议 (HELLO) - Rip
- 8
路由信息协议 (RIP) - IsIs
- 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
不播发路由。 - 帐龄
- 1
播发特定间隔的路由。 - 是
- 2
无限期播发路由。 -
-
RouteMetric
-
-
数据类型：uint16
-
访问类型：只读
提供与到达同一目的地的其他路由相比，此路由的首选项的数字指示。
此属性继承自 CIM_NextHopRoute。
-
-
商店
-
-
数据类型：uint8
-
访问类型：只读
获取一个值，该值指示重新启动后路由状态是否仍然存在。 此属性可包含下列值之一。
值 含义 - Persistent
- 0
重新启动后路由的状态仍然存在。 - 活动
- 1
重新启动后路由的状态不会保留。 -
-
TypeOfRoute
-
-
数据类型：uint16
-
访问类型：只读
表示路由的类型。
此属性继承自 CIM_NextHopRoute。
-
管理员定义的路由 (2)
-
计算路由 (3)
-
实际路由 (4)
-
-
ValidLifetime
-
-
数据类型：datetime
-
访问类型：读/写
获取并设置路由生存期的有效结束时间。 此属性的默认值为无限期。
-
要求
| 最低受支持的客户端 |
Windows 8 |
| 支持的最低服务器版本 |
Windows Server 2012 |
| 命名空间 |
Root\StandardCimv2 |
| MOF |
|
| DLL |
|