PowerShellでポート疎通を確認する方法【pingとの違い・コマンド例】

このサイトはアフィリエイト広告(Amazonアソシエイト含む)を掲載しています。
ノートPCにTest-NetConnectionのコマンドと成功結果を描いた、PowerShellのポート疎通確認の画像

pingコマンドではポート番号を指定した疎通確認はできません。Windowsで特定のTCPポートへ接続できるか確認する場合は、PowerShellのTest-NetConnection ホスト名 -Port ポート番号を使用します。PowerShell 7以降では、Test-Connection ホスト名 -TcpPort ポート番号でも確認できます。

Windows標準のPowerShell 5.1ではTest-NetConnection、PowerShell 7以降ではTest-Connection -TcpPortが使えます。接続先や接続元の情報も見たい場合はTest-NetConnection、タイムアウトを秒単位で指定したい場合はTest-Connection -TcpPortが便利です。

目次

できること早見表

環境・目的使用コマンド
Windows標準PowerShell 5.1Test-NetConnection ホスト名 -Port 443
PowerShell 7以降Test-Connection ホスト名 -TcpPort 443
詳細な切り分けをしたいTest-NetConnection
PowerShell 5.1でTrue / Falseを取得したいTest-NetConnection ホスト名 -Port 443 -InformationLevel Quiet
PowerShell 7以降でTrue / Falseを取得したいTest-Connection ホスト名 -TcpPort 443
UDPポートを確認したいどちらも非対応

pingコマンドの限界とポート指定確認の必要性

pingではポート番号を確認できない

この記事で扱うポート疎通確認は指定したホストのTCPポートへ接続できるかを調べる作業です。接続に成功してもWebページが正常に表示されることやデータベースへログインできることまでは確認できません。サービスの動作はブラウザーや接続用のクライアントでも確認します。

pingコマンドは便利なネットワーク診断ツールですが、ICMPプロトコルを使用しているためTCP / UDPのポート番号を指定した確認はできません。例えば以下のようなシーンでは困りますよね。

  • WebサーバーのTCPポート80や443へ接続できるか確認したい。
  • データベース(ポート3306や5432)への接続を確認したい。
  • 特定のアプリケーションポートが開いているか調べたい。

ICMPにポート番号がない仕組みやIdentifierとポート番号の違いは「pingにポート番号を指定できない理由」で説明しています。


Webでよく使う80番や443番が誰によって決められているのか、ポート番号の割り当てルールを知りたい方はこちらをご覧ください。

Windowsファイアウォールとpingの関係

接続先のWindowsで受信ICMPエコー要求が許可されていないとPCが起動していてもpingへ応答しません。応答するかは適用中のネットワークプロファイルやファイアウォールのルールによって変わります。そのため、pingの失敗だけでは通信経路の問題か設定による遮断かを判断できません。

PowerShellのポート指定確認コマンドを使えばTCP接続を直接試すことができ、より実用的な疎通確認が可能になります。

PowerShellでポート疎通を確認する2つの方法

PowerShellにはポート番号を指定して疎通確認できるコマンドが2種類用意されています。それぞれ特徴が異なるので用途に応じて使い分けましょう。

コマンドこの記事で扱う環境通常のTCP接続結果主な使いどころ
Test-Connection -TcpPortPowerShell 7以降True/False接続可否の確認、タイムアウトを指定した確認
Test-NetConnection -PortWindowsの標準PowerShell 5.1接続先IP、ポート、接続元、成功・失敗などWindowsで接続情報を確認する

Test-NetConnectionも-InformationLevel Quietを付けるとTrue/Falseを返します。PowerShell 7.4以降のTest-Connectionでは-DetailedでTCP接続の試行結果を詳しく表示できます。

Test-ConnectionでTCPポートを確認する

基本的な構文

PowerShell 7以降ではTest-Connectionに-TcpPortを付けてTCPポートへの接続を確認できます。基本的な使い方では接続できればTrue、接続できなければFalseが返ります。

基本構文は次のとおりです。ホスト名とポート番号は確認したい接続先に置き換えてください。

Test-Connection ホスト名 -TcpPort ポート番号

Test-Connection (Microsoft.PowerShell.Management) – PowerShell | Microsoft Learn

実行例:疎通OKの場合

自分のPCのTCPポート8080でサービスが待ち受けている場合の例です。127.0.0.1は自分のPCを指すため、別のPCへ接続できるかを調べる場合はそのPCのIPアドレスやホスト名に置き換えてください。

PowerShell
Test-Connection 127.0.0.1 -TcpPort 8080
PowerShell – 実行結果
True

この結果はポート8080で何らかのサービスが待ち受けておりTCP接続が確立できることを意味します。

Eclipse上で動かしているTomcatをHTTPSでも利用したい場合は自己署名証明書を作成して8443ポートに設定する手順を参考にしてください。

実行例:疎通NGの場合

自分のPCのTCPポート12345でサービスが待ち受けておらず、接続に失敗する場合の例です。

PowerShell
Test-Connection 127.0.0.1 -TcpPort 12345
PowerShell – 実行結果
False

Falseが返ってきた場合通信が確立できなかったことを意味しますが、これだけでは原因がファイアウォール、サービス停止、待ち受けアドレス、経路障害のどれかまでは特定できません。接続先サービスの起動状態、待ち受けポート、Windowsファイアウォールやネットワーク機器の設定もあわせて確認してください。

外部サーバーへの接続確認例

外部サーバーへの確認例としてGoogle Public DNS(8.8.8.8)のTCPポート53へ接続します。このコマンドで確認できるのはTCP接続の可否で、UDPポート53への通信やDNSの名前解決が成功することまでは確認できません。

PowerShell
Test-Connection 8.8.8.8 -TcpPort 53
PowerShell – 実行結果
True

スクリプトでの活用例

Test-Connectionは戻り値がTrue/FalseなのでPowerShellスクリプト内での条件分岐に使いやすいという利点もあります。

PowerShell
$result = Test-Connection example.com -TcpPort 443
if ($result) {
    Write-Host "TCPポート443への接続OK"
} else {
    Write-Host "TCPポート443への接続NG"
}

Test-NetConnectionコマンドの使い方【詳細情報取得】

基本的な構文

Windows標準のPowerShell 5.1ではTest-NetConnectionが使えます。-PortでTCPポートを指定すると接続先や接続元の情報とTCP接続の成功・失敗を確認できます。

公式ドキュメントによると以下のような構文となっています。

Test-NetConnection
[[-ComputerName] <String>]
-Port <Int32>
[-InformationLevel <String>]
[<CommonParameters>]

Test-NetConnection (NetTCPIP) | Microsoft Learn

実行例:疎通OKの場合

自分のPCのTCPポート8080でサービスが待ち受けている場合の例です。

PowerShell
Test-NetConnection 127.0.0.1 -Port 8080
PowerShell – 実行結果
ComputerName     : 127.0.0.1
RemoteAddress    : 127.0.0.1
RemotePort       : 8080
InterfaceAlias   : Loopback Pseudo-Interface 1
SourceAddress    : 127.0.0.1
TcpTestSucceeded : True

Test-Connectionと異なり以下の詳細情報が取得できます。

  • RemoteAddress: 接続先のIPアドレス。
  • RemotePort: 接続先のポート番号。
  • InterfaceAlias: 使用されたネットワークインターフェース名。
  • SourceAddress: 接続元のIPアドレス。
  • TcpTestSucceeded: TCP接続が成功したかどうか(True/False)。

実行例:疎通NGの場合

自分のPCのTCPポート12345でサービスが待ち受けておらず、接続に失敗する場合の例です。

PowerShell
Test-NetConnection 127.0.0.1 -Port 12345
PowerShell – 実行結果
WARNING: TCP connect to (127.0.0.1 : 12345) failed

ComputerName           : 127.0.0.1
RemoteAddress          : 127.0.0.1
RemotePort             : 12345
InterfaceAlias         : Loopback Pseudo-Interface 1
SourceAddress          : 127.0.0.1
PingSucceeded          : True
PingReplyDetails (RTT) : 0 ms
TcpTestSucceeded       : False

この例ではPingSucceeded : True、TcpTestSucceeded : Falseとなっており、ICMPには応答したもののTCPポート12345への接続は失敗しています。サービスの停止、待ち受けポートやアドレスの違い、ファイアウォールによる遮断などが候補になります。結果だけでは原因を特定できないため、接続先の設定も確認してください。

トラブルシューティングでの活用

Test-NetConnectionはネットワークトラブルの切り分けに非常に役立ちます。

PowerShell
Test-NetConnection db-server.example.com -Port 3306

上記はデータベースサーバーのTCPポート3306へ接続できるかを調べる例です。db-server.example.comは実際の接続先に置き換えてください。まずTcpTestSucceededを確認し、失敗していればサービスの起動状態、待ち受け設定、ファイアウォールを順に調べます。表示される項目は結果によって異なるため、PingSucceededが常に含まれるとは限りません。

共有フォルダでTCP接続は成功するのに「アクセスが拒否されました」と表示される場合は、接続アカウントやアクセス権も確認します。C$を指定している場合の確認点はWindowsの管理共有(C$)でアクセス拒否される原因と対処方法でまとめています。


Dockerの2375番を確認する場合はTCP接続の結果に加えて管理APIの応答と公開設定も確認します。Docker APIの外部公開を確認して止める方法を具体例として参考にしてください。

2つのコマンドの使い分けガイド

どちらのコマンドを使うべきか迷ったときの判断基準をまとめました。

Test-Connectionを使うべきケース

  • PowerShell 7.0以上が利用可能な環境。
  • TCP接続の可否をTrue / Falseで確認したい。
  • スクリプト内で条件分岐に使いたい。
  • 複数のホスト・ポートを連続で確認したい。

Test-NetConnectionを使うべきケース

  • PowerShell 5.1環境(Windows標準)で実行したい。
  • 詳細なネットワーク情報も同時に取得したい。
  • トラブルシューティングで原因を切り分けたい。
  • pingの疎通状況も併せて確認したい。

PowerShellの起動方法についてはこちらでも解説してます。

迷いやすいポイント

PowerShellのバージョンはどうやって確認できる?

以下のコマンドで確認できます。

PowerShell
$PSVersionTable.PSVersion

出力されたメジャーバージョンが7以上ならTest-Connectionの-TcpPortオプションが使用可能です。

PowerShellのバージョンアップ方法については以下でも解説してます。

ホスト名でも指定できる?

できます!IPアドレスの代わりにホスト名(FQDN)も指定可能です。

PowerShell
Test-Connection example.com -TcpPort 443

Test-NetConnection example.com -Port 443

複数のポートを一度に確認できる?

Test-Connectionでは配列を使って複数確認できます。

PowerShell
80,443 | ForEach-Object { Test-Connection example.com -TcpPort $_ }

タイムアウト時間を変更できる?

ポート番号を配列で指定しForEach-Objectで1つずつ確認できます。次の例はポート番号と接続結果を並べて表示します。example.comは実際の接続先に置き換えてください。

PowerShell
80, 443 | ForEach-Object {
    [pscustomobject]@{
        Port = $_
        TcpTestSucceeded = Test-Connection example.com -TcpPort $_
    }
}

Test-NetConnectionはデフォルトで数秒のタイムアウトが設定されています。

UDPポートの確認はできる?

Test-NetConnection -PortとTest-Connection -TcpPortで確認できるのはTCPポートです。UDPはTCPのような接続確立処理がないため、同じ方法では疎通を判定できません。UDPを確認する場合は、対象サービスからの応答を確認できる専用コマンドやツールが必要です。

まとめ

PowerShellでポート番号を指定した疎通確認を行う方法について解説しました。

  • pingコマンドではポート番号を指定した確認ができないよ。
  • Test-Connection -TcpPortはPowerShell 7以降で使え、基本的な使い方では接続結果をTrue / Falseで返すよ。
  • Windows標準のPowerShell 5.1ではTest-NetConnection -Portが使え、接続先や接続元の情報も確認できるよ。
  • PingSucceededとTcpTestSucceededを組み合わせることで障害の原因を切り分けられるよ。

疎通確認のほかに使えるPowerShellの基本操作や管理コマンドは用途別のまとめページから探せます。

  • URLをコピーしました!
目次