Test-Connection

Test-Connection [-ComputerName] <string[]> [[-Source] <string[]>] [-AsJob] [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-BufferSize <int>] [-Count <int>] [-Credential <PSCredential>] [-Delay <int>] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Quiet] [-ThrottleLimit <int>] [-TimeToLive <int>] [<CommonParameters>]

C:\PS>test-connection server01

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

説明
-----------
このコマンドは、エコー要求パケット ("ping") をローカル コンピューターから Server01 コンピューターに送信します。ComputerName パラメーターを使用して Server01 コンピューターを指定しますが、オプションのパラメーター名は省略します。

C:\PS>test-connection -computername server01, server02, server12 -credential domain01\user01

説明
-----------
このコマンドは、ping をローカル コンピューターから複数のリモート コンピューターに送信します。Credential パラメーターを使用して、すべてのリモート コンピューターに ping するアクセス許可を持つユーザー アカウントを指定します。

C:\PS>test-connection -source Server02, Server 12, localhost -computername Server01

説明
-----------
このコマンドは、ping をさまざまな送信元コンピューターから 1 台のリモート コンピューター Server01 に送信します。複数のポイントからの接続の待機時間をテストするには、このコマンド形式を使用します。

C:\PS>test-connection -computername Server01 -count 3 -delay 2 -TTL 256 -buffersize 256 -throttle 32

説明
-----------
このコマンドは、ping を 3 回、ローカル コンピューターから Server01 コンピューターに送信します。Test-Connection のパラメーターを使用して、このコマンドをカスタマイズします。

ホップ数が増えたか、またはネットワーク トラフィックが増大したかのいずれかが原因で、ping 応答が通常より遅れることが予想される場合は、このコマンド形式を使用します。

C:\PS>$job = test-connection -computername (get-content servers.txt) -asjob

C:\PS> if ($job.jobstateinfo.state -ne "Running") {$results = receive-job $job}

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

最初のコマンドは、Test-Connection コマンドレットを使用して、社内にある多くのコンピューターに ping します。ComputerName パラメーターの値は、Get-Content コマンドです。このコマンドは Servers.txt ファイルからコンピューター名の一覧を読み取ります。また、AsJob パラメーターを使用して、バックグラウンド ジョブとしてコマンドを実行します。

2 番目のコマンドは、ジョブが実行中でないことをチェックします。実行中でなければ、Receive-Job コマンドを使用して結果を取得し、$results 変数に保存します。

C:\PS>test-connection Server55 -credential domain55\user01 -impersonation Identify

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

C:\PS>if (test-connection -computername Server01 -quiet) {new-pssession Server01}

説明
-----------
このコマンドは、コンピューターに送られた ping が少なくとも 1 回成功した場合にのみ Server01 で PSSession を作成します。

このコマンドは Test-Connection コマンドレットを使用して、Server01 コンピューターに ping します。このコマンドは Win32_PingStatus オブジェクトの代わりに、ブール値を返す Quiet パラメーターを使用します。4 回の ping のうち 1 回でも成功すれば値 $True を返し、成功しなかった場合は $False を返します。

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