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

描述
-----------
這個命令會將回應要求封包 ("Pings") 從本機電腦傳送到 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 從不同的來源電腦傳送到單一遠端電腦 Server01。使用這個命令格式，測試多個點的連線延遲。

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

描述
-----------
這個命令會將三個 Ping 從本機電腦傳送到 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}

描述
-----------
這個範例示範如何以 Windows PowerShell 背景工作執行 Test-Connection 命令。

第一個命令會使用 Test-Connection Cmdlet，Ping 公司中的許多台電腦。ComputerName 參數的值是讀取 Servers.txt 檔案中電腦名稱清單的 Get-Content 命令。這個命令會使用 AsJob 參數，將命令當做背景工作來執行，

第二個命令確認工作是否仍然處於沒有執行的狀態，如果沒有執行，則會使用 Receive-Job 命令取得結果並且將結果儲存在 $results 變數。

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

描述
-----------
這個命令使用 Test-Connection Cmdlet 以 Ping 遠端電腦。該命令使用 Credential 參數指定具有連線至遠端電腦之權限的使用者帳戶，並且使用 Impersonation 參數將模擬層級變更為 "Identify"。

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

描述
-----------
只有當至少有一個 Ping 成功傳送給電腦時，這個命令才會在 Server01 上建立 PSSession。

此命令會使用 Test-Connection Cmdlet 來 Ping 電腦 Server01。此命令會使用 Quiet 參數，此參數會傳回布林值，而不是 Win32_PingStatus 物件。如果四個 Ping 作業中的任何一個成功，此值會是 $True，否則為 false。

如果 Test-Connection 命令傳回 $True 的值，此命令會使用 New-PSSession Cmdlet 建立 PSSession。