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 请求发送到一台远程计算机 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}

说明
-----------
此示例演示了如何将 Test-Connection 命令作为 Windows PowerShell 后台作业运行。

第一条命令使用 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 参数指定有权对远程计算机执行 ping 操作的用户帐户，使用 Impersonation 参数将模拟级别更改为“Identify”。

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

说明
-----------
仅当发送到 Server01 上的至少一条 ping 成功时，此命令才会在该计算机上创建一个 PSSession。

此命令使用 Test-Connection cmdlet 对 Server01 计算机执行 ping 操作。此命令使用 Quiet 参数，这样将返回布尔值，而不是 Win32_PingStatus 对象。如果这四条 ping 中有任何 ping 成功，则该返回值为 $True，否则为 False。

如果 Test-Connection 命令返回 $True 值，则该命令将使用 New-PSSession cmdlet 创建 PSSession。