MSFT_NetRoute class

Represents an IP route for the TCP/IP (Internet Protocol Suite) WMIv2 provider.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[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;
};

Members

The MSFT_NetRoute class has these types of members:

Methods

The MSFT_NetRoute class has these methods.

MethodDescription
Create

Create an IP route.

Find

Retrieves an IP route to the specified remote address.

 

Properties

The MSFT_NetRoute class has these properties.

AddressFamily
Data type: uint16
Access type: Read-only

Gets a value that indicates whether the route uses the IPv4 or IPv6 address family. This property gets one of the following values.

IPv4 (2)
IPv6 (23)
AdminDistance
Data type: uint16
Access type: Read-only

The specific administrative distance of this route, overriding any default distances specified by the system or routing service.

This property is inherited from CIM_NextHopRoute.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

Contains a short textual description of the object.

This property is inherited from CIM_ManagedElement.

Description
Data type: string
Access type: Read-only

Provides a textual description of the object.

This property is inherited from CIM_ManagedElement.

DestinationAddress
Data type: string
Access type: Read-only

The address which serves as the destination to be reached.

This property is inherited from CIM_NextHopRoute.

DestinationPrefix
Data type: string
Access type: Read-only

Gets the destination prefix of the route.

ElementName
Data type: string
Access type: Read-only

Contains a user-friendly name for the object. This property allows each instance to define a user-friendly name in addition to its key properties, identity data, and description information.

This property is inherited from CIM_ManagedElement.

InstanceID
Data type: string
Access type: Read-only
Qualifiers: key, Override ("InstanceID")

Uniquely and opaquely identifies an instance of this class within the scope of the containing Namespace.

Important  In order to ensure uniqueness within the Namespace, the value of InstanceID should be constructed in the following pattern:

OrgID:LocalID

OrgID must include a copyrighted, trademarked or otherwise unique name that is owned by the business entity defining the InstanceID, or be a registered ID that is assigned by a recognized global authority. This is similar to the structure of Schema class names. In addition, to ensure uniqueness the first colon in InstanceID must be between the OrgID andLocalID. Therefor the OrgID must not contain a colon (':').

LocalID is chosen by the business entity and should not be re-used to identify different underlying real-world elements.

If the preceding pattern is not used, the defining entity must assure that the resultant InstanceID is not re-used across any InstanceIDs produced by this or other providers for this Namespace.

For Distributed Management Task Force (DMTF) defined instances, the pattern must be used with the OrgID set to CIM.

 

This property is inherited from CIM_NextHopRoute.

InterfaceAlias
Data type: string
Access type: Read-only

Gets the interface alias of the route.

InterfaceIndex
Data type: uint32
Access type: Read-only

Gets the interface index of the route.

IsStatic
Data type: boolean
Access type: Read-only

TRUE indicates that this is a static route, and FALSE indicates a dynamically-learned route.

This property is inherited from CIM_NextHopRoute.

NextHop
Data type: string
Access type: Read-only

Gets the address of the next hop for the route.

PreferredLifetime
Data type: datetime
Access type: Read/write

Gets and sets the preferred end time of the lifetime of the route. The default value for this property is infinite.

Protocol
Data type: uint16
Access type: Read-only

The protocol from which the route was learned.

ValueMeaning
Other
0

other protocol

Local
1

local routing

NetMgmt
2

Network Management static routing protocol (NETMGMT)

Icmp
3

Internet Control Message Protocol (ICMP)

Egp
4

Exterior Gateway Protocol (EGP)

Ggp
5

Gateway-to-Gateway Protocol (GGP)

Hello
6

Hellospeak protocol (HELLO)

Rip
7

Routing Information Protocol (RIP)

IsIs
8

Intermediate System to Intermediate System (IS-IS)

EsIs
9

End System to Intermediate System (ES-IS)

Igrp
10

Interior Gateway Routing Protocol (IGRP)

Bbn
11

BBN protocol

Ospf
12

Open Shortest Path First (OSPF)

Bgp
13

Border Gateway Protocol (BGP)

Idpr
14

Interdomain Routing Protocol (IDPR)

Eigrp
15

Enhanced Interior Gateway Routing Protocol (EIGRP)

Dvmrp
16

Distance Vector Multicast Routing Protocol (DVMRP)

Rpl
17

Routing Protocol for Low-Power and Lossy Networks (RPL)

Dhcp
18

Dynamic Host Configuration Protocol (DHCP)

 

Publish
Data type: uint8
Access type: Read/write

Gets and sets a value that indicates how to advertise the route. The default value for this property is 0.

ValueMeaning
No
0

Do not advertise the route.

Age
1

Advertise the route for a specific interval.

Yes
2

Advertise the route indefinitely.

 

RouteMetric
Data type: uint16
Access type: Read-only

Provides a numeric indication as to the preference of this route, compared to other routes that reach the same destination.

This property is inherited from CIM_NextHopRoute.

Store
Data type: uint8
Access type: Read-only

Gets a value that indicates whether the state of the route persists after a reboot. This property can contain one of the following values.

ValueMeaning
Persistent
0

The state of the route persists after a reboot.

Active
1

The state of the route does not persist after a reboot.

 

TypeOfRoute
Data type: uint16
Access type: Read-only

Indicates the type of route.

This property is inherited from CIM_NextHopRoute.

Administrator Defined Route (2)
Computed Route (3)
Actual Route (4)
ValidLifetime
Data type: datetime
Access type: Read/write

Gets and sets the valid end time of the lifetime of the route. The default value for this property is infinite.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Namespace

Root\StandardCimv2

MOF

NetTCPIP.mof

DLL

NetTCPIP.dll

See also

CIM_NextHopRoute
NetTCPIP Provider Classes

 

 

Community Additions

ADD
Show: