Test-NetConnection — Stop on errorIT technician command center
● ITSign inMembers
PowerShell · Windows Administration

Test-NetConnection — Stop on error

Run the command with terminating error handling. Base task: Test TCP connectivity to a host and port.

Copy-ready commandTest-NetConnection — Stop on error
try { Test-NetConnection server01 -Port 443 -ErrorAction Stop } catch { Write-Error $_.Exception.Message }

Requirements and permissions

Requirements
Windows PowerShell 5.1 or PowerShell 7
Permissions
Varies by command
Last reviewed
2026-08-01

Examples

Stop on error

Run the command with terminating error handling.

try { Test-NetConnection server01 -Port 443 -ErrorAction Stop } catch { Write-Error $_.Exception.Message }

Common errors

Command or option not supported

Confirm the installed platform version supports the base command and the added output or wrapper option.

Access denied or insufficient privileges

Run with the administrative role or delegated permission required by the underlying command.