PowerShell Test-NetConnection：Pingより高機能なネットワーク診断の決定版

はじめに：なぜPingだけでは不十分なのか？

ネットワークの疎通確認と言えば、多くの人がまず頭に浮かべるのが「Ping」コマンドでしょう。コマンドプロンプトやPowerShellで ping 対象ホスト と打てば、相手までの通信が可能かどうか、遅延はどれくらいかを確認できます。手軽で非常に便利なツールですが、ネットワーク診断の場面においては、Pingだけでは情報が不足することが少なくありません。

Pingは「ICMP (Internet Control Message Protocol)」というプロトコルを利用して、対象ホストにエコー要求を送信し、応答があるかを確認するツールです。これはネットワーク層（OSI参照モデルのレイヤー3）での基本的な接続性を確認するには有効です。しかし、現代のネットワーク環境はより複雑です。

特定のアプリケーションが使用するTCPポートは開いているか？
途中のファイアウォールで通信がブロックされていないか？
特定のサービス（Webサーバー、SSHサーバー、データベースサーバーなど）が実際に待機しているか？
通信経路のどこかに問題や遅延はないか？

これらの問いにPingは答えることができません。Pingで疎通確認ができても、特定のサービスに接続できないという状況は頻繁に発生します。これは、Pingが使用するICMPプロトコルは許可されていても、サービスが使用するTCPやUDPポートがファイアウォールで閉じられていたり、サービス自体が停止していたりする場合があるためです。

そこで登場するのが、PowerShellの強力なコマンドレット Test-NetConnection です。Test-NetConnection は、PingのようなICMPベースのテストだけでなく、TCPポートへの接続テストや、通信経路のトレースルートなど、 Pingよりもはるかに多機能なネットワーク診断 capabilities を提供します。これにより、Pingでは分からなかったネットワークの問題や、特定のサービスへの接続障害の原因をより深く掘り下げて特定することが可能になります。

この記事では、Test-NetConnection コマンドレットの基本的な使い方から、Pingを凌駕する様々な高機能な使い方、詳細な出力の読み方、実践的な応用例、そして知っておくべき注意点まで、徹底的に解説します。これを読めば、あなたのネットワーク診断能力が格段に向上することでしょう。

Test-NetConnectionとは？

Test-NetConnection は、PowerShell 4.0以降で利用可能な組み込みコマンドレットです。その主な目的は、ネットワーク接続の検証です。具体的には、以下の種類のテストを実行できます。

ICMP pingテスト: 対象ホストへの到達性を確認します。これは従来のPingコマンドと同等か、それ以上の情報を提供します。
TCPポート接続テスト: 特定のホストの指定したTCPポートが開いており、接続を受け付けているかを確認します。これはアプリケーション層に近いレベルでの疎通確認に非常に有効です。
IPsecルールテスト: ネットワーク接続がIPsecルールによって許可されているかを確認します（やや高度な機能であり、本記事では主に前2者に焦点を当てます）。
トレースルート: 対象ホストまでのネットワークパス（経由するルーターなど）を表示し、各ホップでの遅延を確認します。

Test-NetConnection の大きな利点は、これらの異なる種類のテストを単一のコマンドレットで実行できること、そしてその結果がPowerShellのオブジェクトとして返されるため、他のコマンドレットと連携したり、スクリプトで処理したりしやすい点です。

Ping (`Test-Connection`) と Test-NetConnection の違い

PowerShellには、Pingと同等の機能を持つ Test-Connection というコマンドレットも存在します。Test-Connection は、従来の ping.exe コマンドの機能をラップしたようなもので、ICMPエコー要求/応答に特化しています。複数回pingを実行したり、詳細な統計情報を表示したりする点で ping.exe より高機能ですが、基本的にはICMPレベルでのテストです。

一方、Test-NetConnection は、ICMPだけでなくTCPテストやトレースルート機能を統合しています。これにより、Test-Connection や ping.exe では不可能な、特定のポートへの接続性確認や、詳細なネットワークパスの分析が可能になります。

機能/特徴	`ping.exe`	`Test-Connection`	`Test-NetConnection`
ICMP Pingテスト	○	○	○
TCPポートテスト	×	×	○
トレースルート	`tracert.exe` を使用	×	○
出力形式	テキスト	オブジェクト/テキスト	オブジェクト
PowerShell連携	×	○	○
詳細度	標準	標準/詳細	基本/詳細 (`-InformationLevel`)
利用可能なプロトコル	ICMP	ICMP	ICMP, TCP

この表からもわかるように、Test-NetConnection は Test-Connection や ping.exe/tracert.exe の機能を統合しつつ、特にTCPポートテストという強力な機能を追加しています。したがって、ネットワーク診断の際には、まず Test-NetConnection を試すのが現代的なアプローチと言えるでしょう。

基本的な使い方：ターゲットを指定して実行

Test-NetConnection の最も基本的な使い方は、テスト対象のホスト名またはIPアドレスを指定するだけです。

powershell Test-NetConnection www.google.com

またはIPアドレスで指定します。

powershell Test-NetConnection 8.8.8.8

これらのコマンドを実行すると、Test-NetConnection はデフォルトで以下のテストを実行します。

名前解決: 指定されたホスト名があれば、そのIPアドレスを解決します。
ICMP Pingテスト: 対象IPアドレスに1回Pingを実行します。

そして、その結果を以下のような形式で出力します（環境や結果によって内容は異なります）。

ComputerName : www.google.com RemoteAddress : 172.217.26.100 InterfaceAlias : Wi-Fi SourceAddress : 192.168.1.10 PingSucceeded : True

この基本的な出力には、以下の情報が含まれています。

ComputerName: テスト対象として指定した名前またはIPアドレスです。
RemoteAddress: 名前解決された対象のIPアドレスです。IPアドレスで指定した場合は、そのIPアドレスが表示されます。
InterfaceAlias: テストに使用されたローカルネットワークインターフェースの名前です（例: Wi-Fi, Ethernet）。
SourceAddress: テストを実行したローカルマシンのIPアドレスです。
PingSucceeded: ICMP Pingテストが成功したかどうかを示します (True または False)。

この情報だけでも、指定したホストへの基本的なIP接続が可能かどうか、どのインターフェースとローカルIPアドレスが使用されたか、そして名前解決が成功したかを確認できます。しかし、これはPingと同等レベルの情報です。Test-NetConnection の真価はこれから紹介する機能にあります。

ICMP Ping機能としての使い方：Ping以上の情報を取得

Test-NetConnection をPingツールとして使用する場合、デフォルトの実行以外にもいくつかのオプションがあります。

Pingパケット数の指定

デフォルトでは1回しかPingを実行しませんが、-Count パラメータを使用すると、実行回数を指定できます。これは ping -n オプションに相当します。

powershell Test-NetConnection www.google.com -Count 4

このコマンドは、Googleに対して4回Pingを実行します。出力はデフォルトの形式で4回分表示されるわけではなく、あくまで最終的な成功/失敗と、場合によっては詳細情報（後述）に影響します。Test-NetConnection の設計思想としては、Pingテスト自体よりも、その結果（到達できたか）を他のテストと組み合わせて確認することに重きが置かれているようです。もし複数回のPing統計情報（平均応答時間、パケットロス率など）が必要な場合は、やはり Test-Connection -Count を使用する方が適しています。

TTL (Time To Live) の指定

-TTL パラメータを使用すると、IPパケットのTime To Live値を指定できます。これはパケットがネットワーク上で経由できるルーターの最大数を制限します。

powershell Test-NetConnection www.google.com -TTL 10

このパケットは、経由するルーターの数が10を超えると破棄されます。TTLは主にネットワークループを防ぐために使用されますが、トレースルートのようにパケットが途中で破棄される挙動を利用して経路を特定する際にも重要になります（Test-NetConnection の -TraceRoute オプションは内部的にこの原理を利用します）。

Don’t Fragment フラグの指定

-DontFragment パラメータを使用すると、IPパケットにDon’t Fragment (DF) フラグを設定できます。このフラグが設定されたパケットは、途中のルーターでMTU（Maximum Transmission Unit）よりも大きい場合にフラグメント（分割）されず、代わりに破棄されます。これにより、ネットワークパス上のMTUを検出するために使用できます（PingによるMTU確認は「Path MTU Discovery」と呼ばれます）。

powershell Test-NetConnection www.google.com -DontFragment

もしMTUよりも大きなサイズのパケットで -DontFragment を指定してPingが失敗する場合、そのパスのMTUが小さいことを示唆します。パケットサイズは Test-NetConnection では直接指定するパラメータは見当たりませんが、内部的に使用されるパケットサイズにこのオプションが影響します。より詳細なMTU診断には Test-Connection -DontFragment -Size の方が適している場合が多いです。

Source IPアドレスの指定

複数のネットワークインターフェースを持つホストからテストを実行する場合、-Source パラメータを使用して、テストパケットの送信元となるローカルIPアドレスを指定できます。

powershell Test-NetConnection www.google.com -Source 192.168.1.10

これは、特定のネットワークインターフェースを経由した接続性を確認したい場合に役立ちます。

TCPポート接続テスト機能：Test-NetConnectionの真骨頂

PingによるICMPテストは、ネットワーク層での基本的な到達性を確認できますが、それだけでは不十分なケースが多いことは既に述べました。Webサイトが見れない、SSHで接続できない、データベースに繋がらないといったアプリケーションレベルの問題は、IPレベルでは疎通できていても、特定のTCPポートが閉じている、サービスが起動していない、ファイアウォールでブロックされている、といった原因で発生することがほとんどです。

Test-NetConnection の最も強力で、Pingにはない機能が、このTCPポート接続テストです。-Port パラメータを使用して、対象ホストの特定のTCPポートへの接続を試みることができます。

基本的なTCPポートテスト

powershell Test-NetConnection www.google.com -Port 80

このコマンドは、www.google.com のTCP 80番ポート（HTTPのデフォルトポート）への接続を試みます。実行結果の出力に注目してください。

ComputerName : www.google.com RemoteAddress : 172.217.26.100 RemotePort : 80 InterfaceAlias : Wi-Fi SourceAddress : 192.168.1.10 TcpTestSucceeded : True

出力結果に RemotePort と TcpTestSucceeded という新しいプロパティが追加されています。

RemotePort: テスト対象として指定したTCPポート番号です。
TcpTestSucceeded: TCP接続テストが成功したかどうかを示します (True または False)。

TcpTestSucceeded が True であれば、指定したホストの指定したポートに対して、クライアントからサーバーまで（途中のルーターやファイアウォールを通過して）、TCP接続を確立できたことを意味します。これは、そのポートでサービスが待機しており、かつネットワーク上のどの機器（クライアント側のOSファイアウォール、企業の境界ファイアウォール、サーバー側のOSファイアウォールなど）もその接続をブロックしていないことを強力に示唆します。

もし接続に失敗した場合、TcpTestSucceeded は False となります。

powershell Test-NetConnection www.google.com -Port 12345 # 通常は開いていないポート

ComputerName : www.google.com RemoteAddress : 172.217.26.100 RemotePort : 12345 InterfaceAlias : Wi-Fi SourceAddress : 192.168.1.10 TcpTestSucceeded : False

このように TcpTestSucceeded が False であれば、以下のいずれかの可能性があります。

対象ホスト上の指定ポートでサービスがリスニングしていない。
対象ホストのOSファイアウォールがそのポートへの接続をブロックしている。
クライアントと対象ホスト間のネットワーク経路上のファイアウォールがそのポートの通信をブロックしている。
ネットワークが到達できない（この場合、名前解決やPingも失敗する可能性が高いですが、ICMPだけ許可してTCPはブロックする設定もあり得ます）。

よく使われるポートでのテスト例

様々なサービスの接続性確認に -Port オプションは非常に役立ちます。

Webサーバー (HTTP/HTTPS):
powershell Test-NetConnection your-web-server.com -Port 80 # HTTP Test-NetConnection your-web-server.com -Port 443 # HTTPS
Webサイトが見れない場合に、まずこのテストを行います。Pingが通ってもこれらのポートテストが失敗する場合、サーバー側のWebサービスが停止しているか、ファイアウォール問題の可能性が高いです。
SSHサーバー:
powershell Test-NetConnection your-ssh-server.com -Port 22
LinuxサーバーなどにSSH接続できない場合に有効です。
RDPサーバー:
powershell Test-NetConnection your-rdp-server.com -Port 3389
Windowsのリモートデスクトップ接続ができない場合に有効です。
SQL Server:
powershell Test-NetConnection your-sql-server.com -Port 1433
SQL Serverへの接続問題切り分けに。
MySQL Server:
powershell Test-NetConnection your-mysql-server.com -Port 3306
MySQL/MariaDBへの接続問題切り分けに。
PostgreSQL Server:
powershell Test-NetConnection your-postgres-server.com -Port 5432
PostgreSQLへの接続問題切り分けに。

このように、対象のサービスが使用するポートを指定して Test-NetConnection を実行することで、「ネットワーク的には接続できる状態か？」、そして「対象ポートでサービスが接続を受け付けているか？」を効率的に確認できます。これは、Pingだけでは決して得られない重要な情報です。

トレースルート機能：通信経路を可視化する

ネットワークの問題を切り分ける際、対象ホストに到達できない場合に「通信経路のどこで問題が発生しているか」を知ることは非常に重要です。従来の tracert.exe コマンドや traceroute コマンドがこれを提供しますが、Test-NetConnection はこの機能も統合しています。-TraceRoute パラメータを使用します。

powershell Test-NetConnection www.google.com -TraceRoute

このコマンドを実行すると、対象ホストまでのネットワーク上のルーター（ホップ）を順番に表示し、各ホップへの応答時間などを計測します。

“`
ComputerName : www.google.com
RemoteAddress : 172.217.26.100
InterfaceAlias : Wi-Fi
SourceAddress : 192.168.1.10
PingSucceeded : True

TraceRoute

HOP RTT IPAddress
— — ———
1 0 ms 192.168.1.1
2 10 ms 10.0.0.1
3 20 ms vpn-gateway.yourcompany.com
4 35 ms some-router-in-isp.com
…
n 100 ms 172.217.26.100
“`

出力結果には、まず通常のPingテストの結果が表示され、その後に TraceRoute セクションが表示されます。

HOP: 経由したルーターの順番（ホップ数）です。
RTT: Round Trip Time（往復時間）の目安です。このホップまでの通信にかかった時間を示します。アスタリスク(*)が表示される場合は、そのホップからの応答がなかったことを意味します。
IPAddress: そのホップのルーターのIPアドレスです。名前解決ができればホスト名も表示されることがあります。

このトレースルート情報から、以下のことを診断できます。

どこまで到達できるか: トレースが途中で停止したり、連続してアスタリスクが表示されるホップがある場合、そのホップの先でパケットがドロップされている可能性があります。これは、そのルーター自体に問題があるか、またはそのルーターの先のネットワーク（ファイアウォールなど）で通信がブロックされていることを示唆します。
ネットワーク遅延: 各ホップのRTTを確認することで、どこで遅延が発生しているかを特定できます。特定のホップから急激にRTTが増加する場合、その区間にボトルネックが存在する可能性があります。
通信経路: 予想していた経路と異なる経路を通っている場合、ルーティング設定に問題がある可能性も考えられます。

最大ホップ数の指定

デフォルトの最大ホップ数は30ですが、-MaxHops パラメータを使用して変更できます。

powershell Test-NetConnection your-remote-network.com -TraceRoute -MaxHops 15

これは、特定のネットワークセグメント内での経路確認など、調査範囲を限定したい場合に役立ちます。

トレースルートはPingとは異なるメカニズム（通常はTTLを利用したICMP Time Exceededメッセージ）を使用するため、Pingは成功してもトレースルートが途中で停止したり、逆にPingは失敗してもトレースルートは終点まで到達する、といったケースもあり得ます。後者の場合、終点ホストがICMPエコー要求には応答しない設定になっているが、ルーターは応答する設定になっている、といった状況が考えられます。

詳細な出力：-InformationLevel “Detailed”

Test-NetConnection は、デフォルトでは重要な情報のみを簡潔に表示しますが、-InformationLevel パラメータに "Detailed" を指定することで、より多くの技術的な情報を取得できます。

powershell Test-NetConnection www.google.com -InformationLevel "Detailed"

このコマンドを実行すると、出力される情報量が大幅に増えます。以下はその出力例（一部抜粋）です。

“`
ComputerName : www.google.com
RemoteAddress : 172.217.26.100
RemotePort :
InterfaceAlias : Wi-Fi
SourceAddress : 192.168.1.10

TcpConnection

TcpState : Listen/Established/TimeWait/Closed (接続状態によって変化)
LocalAddress : 192.168.1.10
LocalPort : 51234 (クライアント側のポート)
RemoteAddress : 172.217.26.100
RemotePort : 80

Ping

PingSucceeded : True
PingReplyDetails (System.Net.NetworkInformation.PingReply) :
Status : Success/TimedOut
Address : 172.217.26.100
RoundtripTime : 50
BufferSize : 32
…

TraceRoute

Hop : 1
Address : 192.168.1.1
RoundtripTime : 0

Hop : 2
Address : 10.0.0.1
RoundtripTime : 12

…

Hop : n
Address : 172.217.26.100
RoundtripTime : 105

Detailed information for TCP test (if -Port is specified)
…
“`

-InformationLevel "Detailed" を指定すると、以下のような追加情報が表示されます。

TcpConnection: -Port オプションを指定してTCPテストを実行した場合、TCP接続の状態（TcpState）や、ローカル/リモートのIPアドレスとポートの詳細が表示されます。TcpState が Established になっていれば、TCP接続が正常に確立されたことを意味します。それ以外の状態（SynSent, SynReceived, FinWait1, CloseWait など）や、Listen/Closed のままテストが終了する場合は、接続が正常に完了しなかったことを示します。
Ping: Pingテストの詳細が表示されます。PingReplyDetails オブジェクトには、ICMP応答の状態（Status）、応答元のIPアドレス（Address）、往復時間（RoundtripTime）、パケットサイズ（BufferSize）など、より詳細なPingの結果が含まれます。
TraceRoute: トレースルートの各ホップについて、個別のオブジェクトとして詳細情報（ホップ数、IPアドレス、往復時間など）が表示されます。

これらの詳細情報は、トラブルシューティングの際に、ネットワークのどの段階で問題が発生しているのか、TCP接続がどの状態で失敗しているのかなどを特定するための貴重な手がかりとなります。例えば、TCPテストで TcpTestSucceeded: False となった場合に、Detailed出力で TcpState を確認することで、SYNパケットは送信できたが応答がないのか（ファイアウォールでブロックされている可能性）、それともRSTパケットが返ってきたのか（ポートが閉じている可能性）など、より具体的な状況を把握できます。

IPv6のサポート

現代のネットワークではIPv4とIPv6が共存しています。Test-NetConnection はIPv6もサポートしており、IPv6アドレスを直接指定してテストを実行できます。

powershell Test-NetConnection 2606:4700::6816:e08 -Port 443 # CloudflareのIPv6アドレス例

また、テスト対象のホスト名がIPv4アドレスとIPv6アドレスの両方を持っている場合（デュアルスタック）、Test-NetConnection はデフォルトでIPv6アドレスを優先して使用しようとします。特定のプロトコル（IPv4またはIPv6）を強制するオプションは -InformationLevel を "Detailed" にした際に出力される Protocol プロパティなどで確認できますが、テスト実行時に明示的に指定する直接的なパラメータは提供されていません。特定のIPバージョンでテストしたい場合は、対象ホストのそのバージョンのIPアドレスを直接指定するのが最も確実です。

コマンドレットのパラメータ詳細

Test-NetConnection には、これまで紹介した以外にもいくつかの便利なパラメータがあります。主なパラメータを以下にまとめます。

-ComputerName <String[]>: テスト対象のホスト名またはIPアドレスを指定します。複数のホストを配列で指定することも可能ですが、その場合、各テストは順番に実行されます。このパラメータは位置指定可能であり、多くの場合は省略して引数を直接指定します（例: Test-NetConnection hostname）。
-Port <Int32>: TCPポート番号を指定してTCP接続テストを実行します。このパラメータを指定しない場合、デフォルトでICMP Pingテストが実行されます。
-InformationLevel <String>: 出力の詳細度を指定します。"Basic"（デフォルト）または "Detailed" を指定します。
-TraceRoute: トレースルートを実行します。
-Count <Int32>: ICMP Pingテストの実行回数を指定します（デフォルトは1回）。
-TTL <Int32>: ICMP PingパケットのTTL値を指定します。
-Source <String>: テストパケットの送信元となるローカルIPアドレスを指定します。
-DontFragment: ICMP PingパケットにDon’t Fragmentフラグを設定します。
-MaxHops <Int32>: トレースルートの最大ホップ数を指定します（デフォルトは30）。
-Quiet: ブール値（$True または $False）のみを返します。これはスクリプトでテスト結果を単純に真偽値で判断したい場合に便利です。-Port が指定されている場合は TcpTestSucceeded の値、指定されていない場合は PingSucceeded の値が返されます。
powershell $isWebPortOpen = Test-NetConnection www.example.com -Port 443 -Quiet if ($isWebPortOpen) { Write-Host "Webサーバーの443ポートは開いています。" } else { Write-Host "Webサーバーの443ポートは閉じているか、到達できません。" }
-SkipDNS: ホスト名のDNS名前解決をスキップし、指定された文字列をそのままIPアドレスとして扱おうとします。文字列が有効なIPアドレス形式でない場合、エラーになる可能性があります。これは、DNSが機能していない状況で特定のIPアドレスへの接続性を確認したい場合に役立ちます。

これらのパラメータを組み合わせることで、様々なシナリオに対応した柔軟なネットワーク診断を実行できます。

応用例と実践的なシナリオ

Test-NetConnection の強力な機能は、単にコマンドを手で実行するだけでなく、PowerShellスクリプトに組み込むことで真価を発揮します。ここではいくつかの応用例を紹介します。

例1：複数のサーバーの特定のポートの可用性をチェックする

運用している複数のWebサーバーやデータベースサーバーの特定のポートが応答しているか、定期的に確認したい場合があります。

“`powershell

チェック対象のサーバーリストとポート

$servers = @(
@{ Name = “WebServer01”; Address = “192.168.1.101”; Port = 80; Service = “HTTP” },
@{ Name = “WebServer02”; Address = “192.168.1.102”; Port = 443; Service = “HTTPS” },
@{ Name = “DBServer01”; Address = “192.168.1.201”; Port = 1433; Service = “SQL” },
@{ Name = “AppServer01”; Address = “192.168.1.202”; Port = 8080; Service = “CustomApp” }
)

Write-Host “=== サーバーポート接続テスト ===”
Write-Host “”

foreach ($server in $servers) {
Write-Host “[$($server.Name)] $($server.Address):$($server.Port) ($($server.Service)) に接続テスト中…”

try {
    $result = Test-NetConnection -ComputerName $server.Address -Port $server.Port -InformationLevel Detailed -ErrorAction Stop
    # ErrorAction Stop を指定しないと、失敗時にエラーが表示されるがスクリプトは停止しない

    if ($result.TcpTestSucceeded) {
        Write-Host "  => 成功！ (RTT: $($result.PingReplyDetails.RoundtripTime)ms)"
    } else {
        Write-Host "  => 失敗。原因: $($result.TcpConnection.TcpState) state, PingSucceeded: $($result.PingSucceeded)"
        # Detailed出力でTcpConnection.TcpStateも確認できる
        # PingSucceededがFalseならIP到達性から問題
        # PingSucceededがTrueでもTcpTestSucceededがFalseならポート/ファイアウォール問題
    }
}
catch {
    # Test-NetConnection自体がエラーになった場合（例: ホスト名解決失敗）
    Write-Host "  => エラー発生: $($_.Exception.Message)"
}

Write-Host ""
Start-Sleep -Milliseconds 500 # 短い間隔を置いて次のテストへ

}

Write-Host “=== テスト完了 ===”
“`

このスクリプトは、サーバーリストを定義し、それぞれのサーバーに対して指定されたポートへの接続テストをループで実行します。結果を分かりやすく表示し、TCP接続が成功したか、失敗したかの情報に加え、詳細情報レベルでの診断に役立つTcpStateやPingSucceededの結果も出力しています。-ErrorAction Stop を指定することで、コマンドレット自体が失敗した場合（例: ホスト名解決不可）にtry/catchブロックで捕捉できるようにしています。

例2：ネットワークパス上の問題を自動的に診断する

特定のサーバーに接続できない場合に、Pingは通るのにTCP接続ができない状況を想定します。原因がファイアウォールか経路上の問題かを切り分けるために、トレースルートとTCPポートテストを組み合わせます。

“`powershell
$targetHost = “your-remote-server.com”
$targetPort = 3389 # RDPポートを例に

Write-Host “=== $targetHost ($targetPort) への接続診断 ===”
Write-Host “”

1. 基本的なPingテスト

Write-Host “1. Pingテスト実行中…”
$pingResult = Test-NetConnection -ComputerName $targetHost -Count 1 -Quiet # Pingが成功したかだけ取得
if ($pingResult) {
Write-Host ” => Ping成功。”

# 2. TCPポートテスト
Write-Host "2. TCPポートテスト($targetPort)実行中..."
$tcpResult = Test-NetConnection -ComputerName $targetHost -Port $targetPort -InformationLevel Detailed -ErrorAction SilentlyContinue # エラーが発生しても止めない

if ($tcpResult.TcpTestSucceeded) {
    Write-Host "  => TCPポート接続成功！"
} else {
    Write-Host "  => TCPポート接続失敗。"
    Write-Host "     診断結果: TcpTestSucceeded = $($tcpResult.TcpTestSucceeded), PingSucceeded = $($tcpResult.PingSucceeded)"
    if ($tcpResult.PingSucceeded -and -not $tcpResult.TcpTestSucceeded) {
         Write-Host "     考えられる原因: 対象ポートが閉じている、サーバー側のファイアウォール、ネットワーク経路上のファイアウォールによるブロックなど。"

        # 3. トレースルート実行 (TCP接続失敗の場合のみ)
        Write-Host "3. 通信経路(トレースルート)確認中..."
        try {
            $traceResult = Test-NetConnection -ComputerName $targetHost -TraceRoute -InformationLevel Detailed -ErrorAction Stop
            Write-Host "TraceRoute結果:"
            $traceResult.TraceRoute | Format-Table -AutoSize
            Write-Host "トレースルート上で応答がないホップや遅延が急増している箇所に問題がある可能性があります。"
        }
        catch {
             Write-Host "  => トレースルート実行中にエラーが発生しました: $($_.Exception.Message)"
        }

    } elseif (-not $tcpResult.PingSucceeded) {
         Write-Host "     考えられる原因: IPレベルでの到達性がない。名前解決失敗、ローカルネットワークの問題、リモートネットワークの問題、経路上の問題など。"
         # IPレベルで到達性がない場合もトレースルートは役立つ
         Write-Host "3. 通信経路(トレースルート)確認中..."
         try {
             $traceResult = Test-NetConnection -ComputerName $targetHost -TraceRoute -InformationLevel Detailed -ErrorAction Stop
             Write-Host "TraceRoute結果:"
             $traceResult.TraceRoute | Format-Table -AutoSize
             Write-Host "トレースルートが途中で途切れている場合、そこまでの経路に問題があります。"
         }
        catch {
             Write-Host "  => トレースルート実行中にエラーが発生しました: $($_.Exception.Message)"
        }
    }
}

} else {
Write-Host ” => Ping失敗。IPレベルでの到達性なし。”
Write-Host ” 考えられる原因: ホスト名解決失敗、ローカルネットワークの問題、リモートネットワークの問題、経路上の問題、ICMPがブロックされているなど。”

# Ping失敗の場合もトレースルートは役立つ
Write-Host "2. 通信経路(トレースルート)確認中..."
 try {
     $traceResult = Test-NetConnection -ComputerName $targetHost -TraceRoute -InformationLevel Detailed -ErrorAction Stop
     Write-Host "TraceRoute結果:"
     $traceResult.TraceRoute | Format-Table -AutoSize
     Write-Host "トレースルートが途中で途切れている場合、そこまでの経路に問題があります。"
 }
catch {
     Write-Host "  => トレースルート実行中にエラーが発生しました: $($_.Exception.Message)"
}

}

Write-Host “”
Write-Host “=== 診断完了 ===”
“`

このスクリプトは、まずPingで基本的な到達性を確認し、成功すれば次に特定のTCPポートへの接続を試みます。TCP接続が失敗した場合、その原因をPingの結果と照らし合わせて推測し、さらにトレースルートを実行して経路上の問題を診断します。Pingが失敗した場合も、経路問題を切り分けるためにトレースルートを実行します。このような自動化された診断スクリプトは、一次切り分けの効率を大幅に向上させます。

例3：`Test-NetConnection` の結果をオブジェクトとして活用する

Test-NetConnection は結果をオブジェクトとして返すため、そのプロパティを簡単に参照したり、他のコマンドレットにパイプラインで渡したりできます。

“`powershell

特定のホストに対する詳細情報を取得

$connectionInfo = Test-NetConnection -ComputerName “www.microsoft.com” -Port 443 -InformationLevel Detailed

オブジェクトのプロパティを参照

$connectionInfo.RemoteAddress
$connectionInfo.TcpTestSucceeded
$connectionInfo.PingSucceeded
$connectionInfo.InterfaceAlias

TCP接続の詳細情報を参照 (Detailed出力時)

if ($connectionInfo.TcpTestSucceeded) {
$connectionInfo.TcpConnection.TcpState
$connectionInfo.TcpConnection.LocalPort
}

トレースルートの結果をフィルタリング/整形 (Detailed出力時)

if ($connectionInfo.TraceRoute) {
$connectionInfo.TraceRoute | Where-Object { $_.RoundtripTime -gt 100 } | Format-Table Hop, IPAddress, RoundtripTime
}

結果をCSVファイルにエクスポート

$connectionInfo | Export-Csv -Path “connection_test_result.csv” -NoTypeInformation

結果を整形して表示

$connectionInfo | Select-Object ComputerName, RemoteAddress, RemotePort, PingSucceeded, TcpTestSucceeded, InterfaceAlias | Format-List
“`

このように、Test-NetConnection の出力がオブジェクトであることは、結果をプログラム的に処理したり、レポートとして出力したりする上で非常に強力です。Format-Table, Format-List, Where-Object, Select-Object, Export-Csv などの標準的なPowerShellコマンドレットと容易に連携できます。

注意点とトラブルシューティング

Test-NetConnection は強力なツールですが、使用する上でいくつかの注意点や、テストがうまくいかない場合のトラブルシューティングポイントがあります。

実行に必要な権限: 通常のICMP PingテストやTCP接続テストは特別な権限なしに実行できますが、特定のネットワーク構成やセキュリティポリシーによっては制限される場合があります。また、-Source パラメータで特定のローカルIPアドレスを指定するなど、ネットワークアダプターの設定に関わる操作を行う場合は、管理者権限が必要になることがあります。
ファイアウォールによるブロック: 最も一般的な問題の原因です。
- クライアント側のファイアウォール: テストを実行しているローカルマシンのファイアウォールが、送信しようとしている特定のプロトコル（ICMP echo request, TCP SYNなど）や、指定した宛先IP/ポートへの通信をブロックしている場合があります。
- ネットワーク経路上のファイアウォール: 企業ネットワークの境界、データセンターの入口、クラウド環境のセキュリティグループ/ネットワークACLなど、クライアントと対象ホストの間のネットワーク経路上のファイアウォールが通信をブロックしている場合があります。
- サーバー側のファイアウォール: 対象ホストのOSファイアウォールが、指定したポートでの受信接続を許可していない場合があります。Test-NetConnection -Port で接続が失敗し、かつPingは成功する場合、サーバー側のファイアウォールか、そのポートでサービスが起動していない可能性が非常に高いです。
DNS名前解決の問題: ホスト名を指定して Test-NetConnection を実行する場合、まずそのホスト名の名前解決（DNSルックアップ）が行われます。名前解決に失敗すると、テスト自体が実行できません。この場合、-SkipDNS オプションを使ってIPアドレスで直接テストを試みるか、Resolve-DnsName コマンドレットなどでDNS設定を別途確認する必要があります。
対象ポートでサービスがLISTENしていない: TCPポートテストが成功するには、対象ホストの指定したポートで、アプリケーションサービスが接続待ち（LISTEN）している必要があります。ポートは開いていても、サービスが停止していれば接続は失敗します。Test-NetConnection -Port はポートが開いているかかつサービスが接続を受け付けているかを確認するものです。ポートが開いているかだけを厳密に確認したい場合は、ポートスキャンツールなど他の方法が必要になることがあります。
ICMPが無効化されている: 一部のネットワーク環境では、セキュリティ上の理由からICMPパケットが完全にブロックされていることがあります。この場合、Pingテスト（Test-NetConnection のPing機能や -TraceRoute）は常に失敗します。Pingが失敗しても、TCPポートテストは成功する場合があるので、ICMPがブロックされている可能性を考慮に入れる必要があります。
PowerShellのバージョン: Test-NetConnection はPowerShell 4.0で導入されました。それより古いバージョン（Windows 7やWindows Server 2008 R2など、デフォルトでPowerShell 2.0がインストールされているOS）では利用できません。その場合はWindows Management Framework (WMF) をインストールしてPowerShellのバージョンを上げる必要があります。
出力の解釈: 特に -InformationLevel "Detailed" を使用した場合、多くの情報が表示されます。各プロパティ（特にTcpConnection.TcpStateなど）の意味を理解していないと、正確な診断ができません。必要に応じてMicrosoft Docsなどの公式ドキュメントを参照することをお勧めします。
テストの性質: Test-NetConnection はあくまでクライアント側から対象ホストへの単方向の接続性をテストするものです。通信は通常双方向で行われるため、例えば対象ホストからクライアントへの接続が必要な場合は、対象ホスト側で同様のテストを実行する必要があります。

これらの注意点を念頭に置き、表示されるエラーメッセージや出力結果を注意深く観察することが、効果的なトラブルシューティングには不可欠です。

まとめ：ネットワーク診断におけるTest-NetConnectionの価値

この記事では、PowerShellの Test-NetConnection コマンドレットについて、Ping (Test-Connection) よりも高機能である点に焦点を当てて詳しく解説しました。

Test-NetConnection は、単なるICMP Pingテストだけでなく、特定のTCPポートへの接続テスト、そして通信経路のトレースルートといった、ネットワーク診断において不可欠な機能を統合した強力なツールです。

Pingでは、ネットワーク層でのIP到達性は確認できても、特定のアプリケーションが使用するポートレベルでの接続性は確認できませんでした。Test-NetConnection -Port は、この問題を解決し、サービスが稼働しているか、ファイアウォールでブロックされていないかなどの重要な情報を得られます。
ネットワークの問題が経路上のどこで発生しているかを特定するには tracert.exe が必要でしたが、Test-NetConnection -TraceRoute を使えば、これも単一コマンドで実行できます。
Test-NetConnection の出力はPowerShellオブジェクトであるため、スクリプトによる自動化や、他のコマンドレットとの連携が容易です。特に -InformationLevel "Detailed" オプションは、詳細な診断情報を提供し、複雑なネットワーク問題の切り分けを助けます。

ネットワーク管理者、システムエンジニア、開発者など、ネットワークに関わるすべての人にとって、Test-NetConnection は必須のツールと言えるでしょう。Pingだけでは得られない情報を活用することで、ネットワーク問題の迅速な特定と解決に大きく貢献します。

ぜひ、日々のネットワーク診断やトラブルシューティングの際に、Test-NetConnection を積極的に活用してみてください。その多機能さと使いやすさから、手放せないツールになるはずです。

PowerShell Test-NetConnection：Pingより高機能な使い方を紹介

PowerShell Test-NetConnection：Pingより高機能なネットワーク診断の決定版

はじめに：なぜPingだけでは不十分なのか？

Test-NetConnectionとは？

Ping (`Test-Connection`) と Test-NetConnection の違い

基本的な使い方：ターゲットを指定して実行

ICMP Ping機能としての使い方：Ping以上の情報を取得

Pingパケット数の指定

TTL (Time To Live) の指定

Don’t Fragment フラグの指定

Source IPアドレスの指定

TCPポート接続テスト機能：Test-NetConnectionの真骨頂

基本的なTCPポートテスト

よく使われるポートでのテスト例

トレースルート機能：通信経路を可視化する

TraceRoute

最大ホップ数の指定

詳細な出力：-InformationLevel “Detailed”

TcpConnection

Ping

TraceRoute

IPv6のサポート

コマンドレットのパラメータ詳細

応用例と実践的なシナリオ

例1：複数のサーバーの特定のポートの可用性をチェックする

チェック対象のサーバーリストとポート

例2：ネットワークパス上の問題を自動的に診断する

1. 基本的なPingテスト

例3：`Test-NetConnection` の結果をオブジェクトとして活用する

特定のホストに対する詳細情報を取得

オブジェクトのプロパティを参照

TCP接続の詳細情報を参照 (Detailed出力時)

トレースルートの結果をフィルタリング/整形 (Detailed出力時)

結果をCSVファイルにエクスポート

結果を整形して表示

注意点とトラブルシューティング

まとめ：ネットワーク診断におけるTest-NetConnectionの価値

コメントする返信をキャンセル

PowerShell Test-NetConnection：Pingより高機能なネットワーク診断の決定版

はじめに：なぜPingだけでは不十分なのか？

Test-NetConnectionとは？

Ping (Test-Connection) と Test-NetConnection の違い

基本的な使い方：ターゲットを指定して実行

ICMP Ping機能としての使い方：Ping以上の情報を取得

Pingパケット数の指定

TTL (Time To Live) の指定

Don’t Fragment フラグの指定

Source IPアドレスの指定

TCPポート接続テスト機能：Test-NetConnectionの真骨頂

基本的なTCPポートテスト

よく使われるポートでのテスト例

トレースルート機能：通信経路を可視化する

TraceRoute

最大ホップ数の指定

詳細な出力：-InformationLevel “Detailed”

TcpConnection

Ping

TraceRoute

IPv6のサポート

コマンドレットのパラメータ詳細

応用例と実践的なシナリオ

例1：複数のサーバーの特定のポートの可用性をチェックする

チェック対象のサーバーリストとポート

例2：ネットワークパス上の問題を自動的に診断する

1. 基本的なPingテスト

例3：Test-NetConnection の結果をオブジェクトとして活用する

特定のホストに対する詳細情報を取得

オブジェクトのプロパティを参照

TCP接続の詳細情報を参照 (Detailed出力時)

トレースルートの結果をフィルタリング/整形 (Detailed出力時)

結果をCSVファイルにエクスポート

結果を整形して表示

注意点とトラブルシューティング

まとめ：ネットワーク診断におけるTest-NetConnectionの価値

コメントする 返信をキャンセル

Ping (`Test-Connection`) と Test-NetConnection の違い

例3：`Test-NetConnection` の結果をオブジェクトとして活用する

コメントする返信をキャンセル