[PowerShell] 110. Test-NetConnection — 포트·경로 진단

개요

Test-NetConnection은 109장의 Test-Connection보다 한 단계 더 깊은 진단 정보를 제공하는 Windows 전용 cmdlet이다. Test-Connection이 범용 크로스플랫폼 ping 대체재라면, Test-NetConnection은 NetTCPIP 모듈(94장에서 다룬 CIM 기반 네트워킹 모듈군의 일부)에 속한 Windows 전용 도구로, TCP 포트 연결·경로 추적·경로 선택 진단까지 하나의 명령으로 묶어서 보여준다.

정신 모델은 “Test-Connection이 ‘살아있는가?‘를 묻는 청진기라면, Test-NetConnection은 ‘어느 경로로, 어느 포트로, 어떤 인터페이스를 거쳐 도달하는가’까지 보여주는 정밀 진단 장비"라는 것이다. 네트워크 문제를 조사할 때 Test-Connection으로 먼저 살아있는지 확인한 뒤, Test-NetConnection으로 구체적인 경로·포트 문제를 파고드는 흐름이 자연스럽다.

사용법

1

Test-NetConnection [[-ComputerName] <컴퓨터명>] [-Port <포트>] [-InformationLevel Detailed|Quiet]

종류

예시

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

Test-NetConnection                                                    # 기본 대상(internetbeacon.msedge.net)으로 ping 테스트

Test-NetConnection -ComputerName "www.contoso.com" -InformationLevel Detailed   # DNS 해석 결과·경로·발신지 주소까지 상세 출력

Test-NetConnection -Port 80 -InformationLevel Detailed                 # 80번 포트 TCP 연결 테스트 + IPsec 규칙·격리 컨텍스트까지 확인

Test-NetConnection -ComputerName "dc01" -CommonTCPPort WINRM             # 83장에서 다룬 WinRM 포트가 열려 있는지 이름으로 바로 확인

Test-NetConnection -ComputerName "www.contoso.com" -DiagnoseRouting -InformationLevel Detailed   # 어떤 발신지 주소·경로가 선택됐는지까지 진단

Test-NetConnection -TraceRoute -Hops 15                                 # 최대 15홉까지 경로 추적

주의사항·함정

Test-NetConnection은 Windows 전용이며 PowerShell 7의 크로스플랫폼 기반을 벗어난다: NetTCPIP 모듈은 macOS/Linux의 pwsh에서 사용할 수 없다. 크로스플랫폼 스크립트를 작성한다면 109장의 Test-Connection -TcpPort로 대체하거나, 플랫폼을 분기해 Windows에서만 Test-NetConnection을 호출해야 한다.

-CommonTCPPort는 4개 값(HTTP/RDP/SMB/WINRM)만 허용한다: HTTPS(443)나 SSH(22) 같은 다른 흔한 포트는 이름으로 지정할 수 없고, 반드시 -Port 매개변수에 숫자를 직접 넣어야 한다. 문서화된 값 이외의 문자열을 넣으면 매개변수 검증 오류가 난다.

-InformationLevel Detailed 없이는 진짜 진단 정보가 상당 부분 생략된다: 기본 출력은 PingSucceeded나 TcpTestSucceeded 같은 요약 속성 위주라, NameResolutionResults·NetRoute·MatchingIPsecRules 같은 상세 필드를 보려면 명시적으로 -InformationLevel Detailed를 지정해야 한다. 문제를 깊이 파고들 필요가 없다면 기본 출력으로 충분하지만, 경로·DNS 문제를 진단할 때는 이 옵션을 빠뜨리기 쉽다.

-DiagnoseRouting은 실제로 트래픽을 보내는 것이 아니라 “어떤 경로가 선택될지"를 시뮬레이션한다: RouteSelectionEvents·SourceAddressSelectionEvents 출력은 라우팅 테이블과 정책에 따른 계산 결과이지, 대상이 실제로 응답했는지를 보장하지 않는다. 연결 자체가 되는지 확인하려면 -Port나 기본 ICMP 테스트를 함께 사용해야 한다.

이식성: -Port를 이용한 TCP 연결 테스트는 Linux의 nc -zv <호스트> <포트>나 telnet <호스트> <포트>와 목적이 같지만, Test-NetConnection은 여기에 더해 경로 선택·IPsec 규칙까지 한 번에 보여준다는 점에서 정보량이 훨씬 많다. -TraceRoute는 Windows CMD의 tracert, Linux의 traceroute와 대응하지만, PowerShell 객체이므로 결과를 Where-Object로 특정 홉만 걸러내는 등 후처리가 가능하다.

Reference

• Test-NetConnection (NetTCPIP) | Microsoft Learn