Test-NetConnection Cmdlet Reference and Usage
Home > Windows > Network Port and Connectivity Testing in Windows > Test-NetConnection Cmdlet Reference and Usage
Description
The Test-NetConnection cmdlet is used to display diagnostic information for network connectivity. It supports:
- Ping test
- TCP port test
- Traceroute
- Route and source address diagnostics
Module
- NetTCPIP
Test-NetConnection: Syntax and Parameter Reference
powershell
Test-NetConnection [[-ComputerName] <String>] [-TraceRoute] [-Hops <Int32>] [-InformationLevel <String>]
Test-NetConnection [[-ComputerName] <String>] [-CommonTCPPort] <String> [-InformationLevel <String>]
Test-NetConnection [[-ComputerName] <String>] -Port <Int32> [-InformationLevel <String>]
Test-NetConnection [[-ComputerName] <String>] [-DiagnoseRouting] [-ConstrainSourceAddress <String>] [-ConstrainInterface <UInt32>] [-InformationLevel <String>]
- -ComputerName - DNS name or IP address of the target.Alias:RemoteAddress, cn
- -Port - TCP port to test (e.g., 80 for HTTP). Alias: RemotePort
- -CommonTCPPort - Predefined service ports (HTTP, RDP, SMB, WINRM)
- -TraceRoute - Performs a traceroute to the destination
- -DiagnoseRouting - Enables route diagnostics
- -ConstrainInterface - Forces diagnostics through a specific interface index
- -ConstrainSourceAddress - Forces diagnostics from a specific source IP address
- -Hops - Sets the number of hops for traceroute
- -InformationLevel - Level of output: Detailed or Quiet
Outputs
- NetRouteDiagnostics — Returned for route diagnostic tests
- NetConnectionResults — Returned for ping or port connection tests
Examples
Example 1: Test ping to default internet beacon
powershell
Test-NetConnection
Example 2: Ping with detailed output
powershell
Test-NetConnection -InformationLevel "Detailed"
Example 3:Test TCP port (HTTP - Port 80)
powershell
Test-NetConnection -Port 80 -InformationLevel "Detailed"
Example 4: Ping a specific remote host
powershell
Test-NetConnection -ComputerName "www.contoso.com" -InformationLevel "Detailed"
Example 5: Route diagnostics for a remote host
powershell
Test-NetConnection -ComputerName www.contoso.com -DiagnoseRouting -InformationLevel Detailed
Example 6: Route diagnostics with constrained interface
powershell
Test-NetConnection -ComputerName "www.contoso.com" -ConstrainInterface 5 -DiagnoseRouting -InformationLevel "Detailed"
Home > Windows > Network Port and Connectivity Testing in Windows > Test-NetConnection Cmdlet Reference and Usage