PowerShell Logo Small

Find-NetRoute



This is the built-in help made by Microsoft for the command 'Find-NetRoute', in PowerShell version 4 - as retrieved from Windows version 'Microsoft Windows 8.1 Enterprise' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Finds the best local IP address and the best route to reach a remote address.

SYNTAX


Find-NetRoute [-AsJob] [-CimSession <CimSession[]>] [-InterfaceIndex <UInt32>] [-LocalIPAddress <String>] [-ThrottleLimit <Int32>] -RemoteIPAddress <String> [<CommonP
arameters>]



Search powershellhelp.space

DESCRIPTION


The Find-NetRoute cmdlet finds the best local IP address and the best route to reach a remote address. Specify the remote address to reach. You can also specify an in
terface and a local address to use to reach the remote address.


For more information about routing, see Chapter 5 - IP Routing (http://technet.microsoft.com/library/bb727001.aspx) in the TechNet library.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=313144
Get-NetRoute
New-NetRoute
Remove-NetRoute
Set-NetRoute

REMARKS

<

Examples


Example 1: Find a local address and route

PS C:\>Find-NetRoute -RemoteIPAddress "10.79.197.200"
IPAddress : 172.31.234.140
InterfaceIndex : 3
InterfaceAlias : Ethernet
AddressFamily : IPv4
Type : Unicast
PrefixLength : 21
PrefixOrigin : Dhcp
SuffixOrigin : Dhcp
AddressState : Preferred
ValidLifetime : 6.00:10:40
PreferredLifetime : 6.00:10:40
SkipAsSource : False
PolicyStore : ActiveStore


Caption :
Description :
ElementName :
InstanceID : :8:8:8:9:55=55;A<8=;8<=<8;55;
AdminDistance :
DestinationAddress :
IsStatic :
RouteMetric : 0
TypeOfRoute : 3
AddressFamily : IPv4
DestinationPrefix : 0.0.0.0/0
InterfaceAlias : Ethernet
InterfaceIndex : 3
NextHop : 172.31.232.1
PreferredLifetime : 8.00:00:00
Protocol : NetMgmt
Publish : No
Store : ActiveStore
ValidLifetime : 8.00:00:00
PSComputerName :
ifIndex : 3



This command finds a NetIPAddress object and NetRoute object to use to access the IP address 10.79.197.200. The command returns two objects. The first object is the l
ocal IP address. The second object is the local route that includes the selected connectivity path and next hop.