PowerShell Logo Small

Test-NetConnection



This is the built-in help made by Microsoft for the command 'Test-NetConnection', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' 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

Displays diagnostic information for a connection.

SYNTAX


Test-NetConnection [[-ComputerName] <String>] [-CommonTCPPort] <String> [-InformationLevel <String>] [<CommonParameters>]
Test-NetConnection [[-ComputerName] <String>] [-Hops <Int32>] [-InformationLevel <String>] [-TraceRoute] [<CommonParameters>]
Test-NetConnection [[-ComputerName] <String>] [-InformationLevel <String>] -Port <Int32> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Test-NetConnection cmdlet displays diagnostic information for a connection. The output includes the results of a DNS lookup, a listing of IP interfaces, an option to
test a TCP connection, IPsec rules, and confirmation of connection establishment.



<

RELATED LINKS


Online Version: http://go.microsoft.com/fwlink/?LinkId=313146

REMARKS

<

Examples


Example 1: Test a connection

PS C:\>Test-NetConnection
ComputerName : gateway.contoso.com

RemoteAddress : 2620:0:30::197

InterfaceAlias : Ethernet 3

SourceAddress : 2001:4898:1b:1046:cda8:e200:e2cd:1e8b

PingSucceeded : True



This command tests a network connection.




Example 2: Test a connection and display detailed results

PS C:\>Test-NetConnection -Port 80 -InformationLevel Detailed
ComputerName : gateway.contoso.com

RemoteAddress : 2620:0:30::197

RemotePort : 80

AllNameResolutionResults : 10.253.21.197

10.79.197.197

2620:0:30::197

MatchingIPsecRules : Ipsec-Win8/Domain-TrafficFromInternet-v6

NetworkIsolationContext : Internet

InterfaceAlias : Ethernet 3

SourceAddress : 2001:4898:1b:1046:cda8:e200:e2cd:1e8b

NetRoute (NextHop) : fe80::21a:30ff:feaf:5400

PingSucceeded : True

PingReplyDetails (RTT) : 1 ms

TcpTestSucceeded : True



This command tests a network connection and sets the InformationLevel parameter to Detailed.




Example 3: Test a connection to a remote host

PS C:\>Test-NetConnection -ComputerName www.contoso.com -InformationLevel Detailed
ComputerName : www.contoso.com

RemoteAddress : 2600:1409::1703:6929

AllNameResolutionResults : 10.3.105.104

10.3.105.113

10.3.105.114

10.3.105.41

10.3.105.43

2600:1409::1703:6929

2600:1409::1703:692b

2600:1409::1703:6972

InterfaceAlias : Ethernet 3

SourceAddress : 2001:4898:1b:1046:cda8:e200:e2cd:1e8b

NetRoute (NextHop) : fe80::21a:30ff:feaf:5400

PingSucceeded : True

PingReplyDetails (RTT) : 164 ms



This command tests a network connection to a remote host named www.contoso.com.