Test-Connection

構文

Test-Connection
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-ComputerName] <String[]>
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Test-Connection
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-ComputerName] <String[]>
    [-Count <Int32>]
    [-Credential <PSCredential>]
    [-Source] <String[]>
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Test-Connection
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-ComputerName] <String[]>
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [-Quiet]
    [<CommonParameters>]

説明

Test-Connection コマンドレットは、インターネット制御メッセージ プロトコル (ICMP) エコー要求パケット (ping) を 1 つ以上のリモート コンピューターに送信し、エコー応答応答を返します。 このコマンドレットを使用して、特定のコンピューターに IP ネットワーク経由で接続できるかどうかを判断できます。

Test-Connectionのパラメーターを使用して、送受信コンピューターの両方を指定したり、コマンドをバックグラウンド ジョブとして実行したり、タイムアウトと ping の数を設定したり、接続と認証を構成したりできます。

使い慣れた ping コマンドとは異なり、 Test-Connection は PowerShell で調査できる Win32_PingStatus オブジェクトを返します。 Quiet パラメーターは、テストされた各接続の System.Boolean オブジェクトの Boolean 値を返します。 複数の接続をテストすると、 Boolean 値の配列が返されます。

例

例 1: リモート コンピューターにエコー要求を送信する

この例では、ローカル コンピューターから Server01 コンピューターにエコー要求パケットを送信します。

Test-Connection -ComputerName Server01

Source        Destination     IPV4Address     IPV6Address  Bytes    Time(ms)
------        -----------     -----------     -----------  -----    --------
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       1

Test-Connection は、 ComputerName パラメーターを使用して Server01 コンピューターを指定します。

例 2: 複数のコンピューターにエコー要求を送信する

この例では、ローカル コンピューターから複数のリモート コンピューターに ping を送信します。

Test-Connection -ComputerName Server01, Server02, Server12

例 3: 複数のコンピューターから 1 台のコンピューターにエコー要求を送信する

この例では、異なるソース コンピューターから 1 台のリモート コンピューター Server01 に ping を送信します。

Test-Connection -Source Server02, Server12, localhost -ComputerName Server01 -Credential Domain01\Admin01

Test-Connection は、 Credential パラメーターを使用して、ソース コンピューターから ping 要求を送信するアクセス許可を持つユーザーの資格情報を指定します。 複数のポイントからの接続の待機時間をテストするには、このコマンド形式を使用します。

例 4: パラメーターを使用してテスト コマンドをカスタマイズする

この例では、 Test-Connection のパラメーターを使用してコマンドをカスタマイズします。 ローカル コンピューターからリモート コンピューターに ping テストが送信されます。

Test-Connection -ComputerName Server01 -Count 3 -Delay 2 -TTL 255 -BufferSize 256 -ThrottleLimit 32

Test-Connection は、 ComputerName パラメーターを使用して Server01 を指定します。 Count パラメーターは、Delay 2 秒間隔で 3 つの ping を Server01 コンピューターに送信することを指定します。

これらのオプションは、ホップ数が長いか、トラフィックの多いネットワーク状態が原因で、ping 応答に通常よりも長い時間がかかると予想される場合に使用できます。

例 5: バックグラウンド ジョブとしてテストを実行する

この例では、powerShell バックグラウンド ジョブとして Test-Connection コマンドを実行する方法を示します。

$job = Test-Connection -ComputerName (Get-Content Servers.txt) -AsJob
if ($job.JobStateInfo.State -ne "Running") {$Results = Receive-Job $job}

Test-Connection コマンドは、企業内の多くのコンピューターに ping を実行します。 ComputerName パラメーターの値は、Servers.txt fileからコンピューター名の一覧を読み取るGet-Content コマンドです。 このコマンドは、 AsJob パラメーターを使用してバックグラウンド ジョブとしてコマンドを実行し、ジョブを $job 変数に保存します。

if コマンドは、ジョブがまだ実行されていないことを確認します。 ジョブが実行されていない場合、 Receive-Job は結果を取得し、 $Results 変数に格納します。

例 6: 資格情報を使用してリモート コンピューターに ping を実行する

このコマンドでは、 Test-Connection コマンドレットを使用してリモート コンピューターに ping を実行します。

Test-Connection Server55 -Credential Domain55\User01 -Impersonation Identify

このコマンドでは、 Credential パラメーターを使用して、リモート コンピューターに ping を実行するアクセス許可を持つユーザー アカウントを指定し、 Impersonation パラメーターを使用して偽装レベルを Identify に変更します。

例 7: 接続テストが成功した場合にのみセッションを作成する

この例では、コンピューターに送信された ping の少なくとも 1 つが成功した場合にのみ、Server01 コンピューターにセッションを作成します。

if (Test-Connection -ComputerName Server01 -Quiet) {New-PSSession Server01}

if コマンドは、Test-Connection コマンドレットを使用して Server01 コンピューターに ping を実行します。 このコマンドでは、Quiet パラメーターを使用します。このパラメーターは、Win32_PingStatus オブジェクトの代わりに Boolean 値を返します。 この値は、4 つの ping のいずれかが成功した場合に $True され、それ以外の場合は $False。

Test-Connection コマンドが $True の値を返す場合、コマンドは New-PSSession コマンドレットを使用してPSSessionを作成します。

パラメーター

-AsJob

-BufferSize

-ComputerName

-Count

-Credential

-DcomAuthentication

-Delay

-Impersonation

-Protocol

-Quiet

-Source

-ThrottleLimit

-TimeToLive

-WsmanAuthentication

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

ManagementObject

既定では、このコマンドレットは ping 応答ごとに Win32_PingStatus オブジェクトを返します。

System.Management.Automation.RemotingJob

AsJob パラメーターを指定すると、このコマンドレットはジョブ オブジェクトを返します。

Boolean

Quiet パラメーターを使用すると、Boolean 値が返されます。 コマンドレットが複数の接続をテストすると、 Boolean 値の配列が返されます。

メモ

このコマンドレットでは、 Win32_PingStatus クラスを使用します。 Get-WMIObject Win32_PingStatus コマンドは、Test-Connection コマンドと同じです。

Source パラメーター セットは、PowerShell 3.0 で導入されました。

関連リンク

• Add-Computer
• Restart-Computer
• Stop-Computer