Test-NetConnection (PowerShell)

Test-NetConnection to polecenie PowerShell sprawdzające dostępność hosta i wskazanego portu sieciowego.

Co sprawdza polecenie Test-NetConnection

Test-NetConnection jest poleceniem PowerShell dostępnym w module NetTCPIP systemu Windows. Służy do wykonywania podstawowych testów łączności z określonym komputerem lub adresem IP. W najprostszym użyciu sprawdza nazwę albo adres hosta, a następnie próbuje nawiązać połączenie z wykorzystaniem mechanizmu ICMP, kojarzonego z poleceniem ping. Wynik może wskazać między innymi nazwę badanego komputera, jego adres zdalny, adres użytego interfejsu lokalnego oraz informację, czy host odpowiedział.

Przykładowe polecenie Test-NetConnection example.com pozwala sprawdzić, czy system może rozwiązać nazwę DNS i skomunikować się z podanym hostem. Sam brak odpowiedzi ICMP nie musi oznaczać awarii sieci, ponieważ zapora sieciowa może blokować echo ICMP, podczas gdy inne połączenia nadal działają. Test należy więc interpretować w odniesieniu do konkretnej usługi, aplikacji i topologii sieci, a nie jako całkowity dowód sprawności wszystkich połączeń.

Test portu TCP z parametrem -Port

Do sprawdzenia dostępności konkretnej usługi TCP służy parametr -Port, na przykład Test-NetConnection 192.168.1.10 -Port 3389. W tym przypadku polecenie próbuje zestawić połączenie TCP z adresem 192.168.1.10 na porcie 3389, który jest standardowo używany przez usługę Pulpit zdalny Microsoft Remote Desktop. Wynik zawiera pole TcpTestSucceeded. Wartość True oznacza, że z badanego komputera udało się nawiązać połączenie TCP z podanym portem, natomiast False oznacza nieudaną próbę.

Nieudany test portu może wynikać z kilku różnych przyczyn: usługa może nie działać, nasłuchiwać na innym porcie, blokować połączenia zaporą albo być niedostępna przez trasę sieciową. Test-NetConnection nie potwierdza poprawnego działania całej aplikacji po samym udanym zestawieniu TCP. Połączenie na porcie może zostać zaakceptowane, mimo że aplikacja później odrzuca logowanie, zwraca błąd protokołu lub nie ma wymaganych zasobów. Do zwięzłego sprawdzenia można użyć przełącznika -InformationLevel Quiet, który zwraca wartość logiczną zamiast rozbudowanego obiektu diagnostycznego.

Parametr -CommonTCPPort pozwala wskazać jedną z nazw usług obsługiwanych przez cmdlet, między innymi HTTP, RDP, SMB oraz WINRM. Jest to skrócona forma testu typowego portu TCP, ale nie zastępuje sprawdzenia rzeczywistej konfiguracji. Jeżeli administrator zmienił port usługi, należy podać jego numer jawnie za pomocą -Port.

Odczytywanie wyników i diagnostyka trasy

Wynik szczegółowy można uzyskać poleceniem Test-NetConnection -ComputerName example.com -Port 443 -InformationLevel Detailed. Port 443 jest standardowo wykorzystywany przez HTTPS, jednak udane połączenie TCP nie weryfikuje certyfikatu TLS, nazwy domenowej w certyfikacie ani poprawności odpowiedzi HTTP. Cmdlet informuje przede wszystkim o osiągalności wskazanego punktu TCP z konkretnego komputera. Przy analizie warto odnotować, czy użyto nazwy DNS, adresu IPv4 czy IPv6, ponieważ każda z tych ścieżek może mieć inną konfigurację i trasę.

Test-NetConnection może również pokazać informacje o trasowaniu. Przełącznik -TraceRoute wykonuje śledzenie kolejnych przeskoków między komputerem lokalnym a wskazanym hostem. Parametr -Hops ogranicza maksymalną liczbę badanych przeskoków. Do diagnostyki wyboru interfejsu i trasy służą także parametry -DiagnoseRouting, -ConstrainInterface oraz -ConstrainSourceAddress. Są przydatne na komputerze wyposażonym w kilka kart sieciowych, na przykład jednocześnie Wi-Fi, Ethernet i aktywny tunel VPN.

Brak odpowiedzi któregoś routera podczas śledzenia trasy nie zawsze oznacza przerwę w połączeniu. Urządzenia pośrednie mogą celowo ignorować pakiety diagnostyczne albo ograniczać odpowiedzi, pozostawiając możliwość komunikacji z dalszymi punktami. Dlatego należy porównywać rezultat z testem portu docelowej usługi. Inaczej interpretuje się sytuację, w której trasa jest częściowo widoczna, ale port odpowiada, a inaczej tę, w której nie działa ani rozwiązywanie DNS, ani połączenie TCP.

Zastosowanie podczas naprawy laptopa i komputera

Podczas diagnostyki komputera Test-NetConnection pomaga rozdzielić problemy z lokalną konfiguracją sieci od problemów dotyczących konkretnego hosta lub usługi. Można kolejno sprawdzić adres bramy, serwer w sieci lokalnej i host internetowy, a następnie porównać port używany przez aplikację. Przykładowo test Test-NetConnection 192.168.1.1 może potwierdzić podstawową komunikację z bramą, natomiast Test-NetConnection example.com -Port 443 sprawdza możliwość zestawienia połączenia HTTPS. Taka kolejność ułatwia ustalenie, czy problem dotyczy interfejsu, adresu IP, DNS, zapory lub zewnętrznej usługi.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i podzespołów, a testy PowerShell mogą stanowić jeden z elementów sprawdzania połączeń sieciowych po naprawie systemu lub konfiguracji karty sieciowej. Samo polecenie nie naprawia sterownika, ustawień zapory ani uszkodzonego okablowania. Dostarcza wynik pomiaru z danego komputera, w danym momencie i przy użyciu aktualnej konfiguracji. Przy powtarzających się problemach warto zapisać pełny wynik wraz z użytym adresem, portem, rodzajem połączenia oraz informacją, czy komputer korzystał z Wi-Fi, Ethernetu lub VPN.