Test-Connection

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

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

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

Test-Connection cmdlet 将 Internet 控制消息协议（ICMP）回显请求数据包（又称为 ping）发送到一台或多台远程计算机，并返回回显响应。 可以使用此 cmdlet 来确定是否可以跨 IP 网络联系特定计算机。

可以使用 Test-Connection 的参数来指定发送和接收计算机、将命令作为后台作业运行、设置超时和 ping 数以及配置连接和身份验证。

与 熟悉的 ping 命令不同，Test-Connection 返回可在 PowerShell 中调查的 Win32_PingStatus 对象。 Quiet 参数为每个测试的连接返回 System.Boolean 对象中的布尔值。 如果测试了多个连接，将返回 布尔 值的数组。

此示例将来自本地计算机的回显请求数据包发送到计算机 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 计算机。

此示例将 ping 从本地计算机发送到多个远程计算机。

Test-Connection -ComputerName Server01, Server02, Server12

此示例将来自不同源计算机的 ping 发送到单个远程计算机 Server01。

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

Test-Connection 使用 Credential 参数指定有权从源计算机发送 ping 请求的用户的凭据。 使用此命令格式测试来自多个点的连接延迟。

此示例使用Test-Connection参数自定义命令。 本地计算机将 ping 测试发送到远程计算机。

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

Test-Connection 使用 ComputerName 参数指定 Server01。 Count 参数指定将三个 ping 发送到 Server01 计算机，延迟 2 秒间隔。

当预计 ping 响应的时间比平常更长时，例如由于跃点数增加或网络流量过大，就可以使用这些选项。

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

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

Test-Connection 命令对企业中的许多计算机执行 ping 操作。 ComputerName 参数的值是一个从 Get-Content读取计算机名称列表的 Servers.txt file 命令。 该命令使用 AsJob 参数将命令作为后台作业运行，并将作业保存在 $job 变量中。

if 命令检查作业是否仍在运行。 如果作业未运行，Receive-Job 获取结果并将其存储在 $Results 变量中。

此命令使用 Test-Connection cmdlet 对远程计算机执行 ping 操作。

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

该命令使用 Credential 参数指定有权 ping 远程计算机的用户帐户和 模拟 参数，以将模拟级别更改为 标识。

仅当至少一个发送到计算机的 ping 成功时，此示例才会在 Server01 计算机上创建会话。

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

if 命令使用 Test-Connection cmdlet ping Server01 计算机。 该命令使用 Quiet 参数，该参数返回 布尔 值，而不是 Win32_PingStatus 对象。 如果四个 ping 中的任何一个成功，则该值 $true;否则为 $false。

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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能用管道将对象传送到此 cmdlet。

默认情况下，此 cmdlet 为每个 ping 答复返回一个 Win32_PingStatus 对象。

如果指定 AsJob 参数，则此 cmdlet 将返回作业对象。

使用 Quiet 参数时，它会返回一个布尔值。 如果 cmdlet 测试多个连接，它将返回一组布尔值。

此 cmdlet 使用 Win32_PingStatus 类。 Get-WmiObject Win32_PingStatus 命令等效于 Test-Connection 命令。

PowerShell 3.0 中引入了 源 参数集。