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.

# Note: replace "*" with a comma-separated lists of properties to show only selected properties.

# displaying information in GridView:# (Note: Out-GridView can only display a maximum of 30 columns. Additional properties are not shown.)Get-WMIObject-ClassWin32_IP4PersistedRouteTable|Select-Object-Property*|Out-GridView-Title"Win32_IP4PersistedRouteTable"

Querying information remotely:

# connecting to a remote machine using current identity:$ComputerName='SomeServerNameOrIP'Get-WMIObject-ClassWin32_IP4PersistedRouteTable-ComputerName$ComputerName

# using credentials:$ComputerName='SomeServerNameOrIP'$Username='mydomain\\myusername'

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:

Caption

Data type String

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

Description

Data type String

The Description property provides a textual description of the object.

Destination

Data type String

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

InstallDate

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.

Mask

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.

Metric1

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.

Name

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.

NextHop

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.).

StartFileName

Data type String

Status

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.

You have a question about WMI in general or this particular WMI Class? Then please visit our free forum: Help me with WMI. There are even more forums to assist you, so you may want to look at the full forum list to pick the best one.

Please use the comment form below to actively submit new content for this page. So if you found an error or have sample code showing this class in action, please share by using the comment form on the bottom of this page.

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.