Home Reference WMI Reference root CIMV2 Win32_IP4PersistedRouteTable


The IP4PersistedRouteTable class contains IP routes that are persisted. By default, the routes you add to the routing table aren’t permanent. You lose these routes when you reboot your computer. However, if you use the command route -p add, Windows NT makes the permanent–so you won’t lose the route when you reboot your computer. Persistent entries are automatically reinserted in your route table each time your computer’s route table is rebuilt. Windows NT stores persistent routes in the Registry. This class deals specifically with IP4 and does not address IPX or IP6.

Quick Start


Most WMI properties are read-only. You can only read values but not change them. Few properties are also writeable. You can assign new values to those properties.

Writeable properties are marked with this icon:   


Data type String

The Caption property is a short textual description (one-line string) of the object.


Data type String

The Description property provides a textual description of the object.


Data type String

The Destination property contains the destination IP address for this persisted route.


Data type DateTime

The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.


Data type String

The Mask property contains the mask used in this persisted entry. Masks should be logical-ANDed with the destination address before being compared to the value in the ipRouteDest field.


Data type SInt32

The Metric1 property contains the primary routing metric for this persisted route. The semantics of this metric are determined by the routing protocol specified in the route’s ipRouteProto value. If this metric is not used, its value should be set to -1.


Data type String

The Name property defines the label by which the object is known. When subclassed, the Name property can be overridden to be a Key property.


Data type String

The NextHop property contains the IP address of the next hop of this persisted route. (In the case of a route bound to an interface that is realized via a broadcast media, the value of this field is the agent’s IP address on that interface.).


Data type String


Data type String

The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are “OK”, “Degraded” and “Pred Fail”. “Pred Fail” indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are “Error”, “Starting”, “Stopping” and “Service”. The latter, “Service”, could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither “OK” nor in one of the other states.

'OK','Error','Degraded','Unknown','Pred Fail','Starting','Stopping','Service','Stressed','NonRecover','No Contact','Lost Comm'



See Also

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:25:18 (UTC).