Test-Connection

模块:: Microsoft.PowerShell.Management

将 ICMP 回显请求数据包或 ping 发送到一台或多台计算机。

语法

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

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

Test-Connection
    [-ComputerName] <String[]>
    [-Authentication <AuthenticationLevel>]
    [-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 对象中的布尔值。如果测试了多个连接，将返回 布尔值 值的数组。

示例

示例 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：将来自多台计算机的回显请求发送到计算机

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

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 使用 TargetName 参数指定 Server01。 Count 参数指定将三个 ping 发送到 Server01 计算机，延迟 2 秒间隔。

当 ping 响应预计花费的时间比平常长（因为跃点数延长或高流量网络条件）时，可以使用这些选项。

示例 5：以后台作业身份运行测试

此示例演示如何将 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 变量中。

示例 6：使用凭据 Ping 远程计算机

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

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

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

示例 7：仅当连接测试成功时创建会话

仅当至少一个发送到计算机的 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。

参数

-AsJob

指示此 cmdlet 作为后台作业运行。

若要使用此参数，必须将本地和远程计算机配置为远程处理，并且，在 Windows Vista 和更高版本的 Windows 操作系统上，必须使用 以管理员身份运行 选项打开 PowerShell。有关详细信息，请参阅 about_Remote_Requirements。

指定 AsJob 参数时，该命令将立即返回表示后台作业的对象。作业完成后，可以继续在会话中工作。作业在本地计算机上创建，远程计算机的结果会自动返回到本地计算机。若要获取作业结果，请使用 Receive-Job cmdlet。

有关 PowerShell 后台作业的详细信息，请参阅 about_Jobs 和 about_Remote_Jobs。

类型:	SwitchParameter
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Authentication

指定用于 WMI 连接的身份验证级别。 Test-Connection 使用 WMI。

有效值如下所示：

未更改：身份验证级别与上一个命令相同。
默认：Windows 身份验证。
无：无 COM 身份验证。
连接：连接级 COM 身份验证。
呼叫：呼叫级 COM 身份验证。
数据包：数据包级 COM 身份验证。
PacketIntegrity：数据包完整性级别的 COM 身份验证。
PacketPrivacy：数据包隐私级 COM 身份验证。

默认值为 数据包，其枚举值为 4。有关此参数的值的详细信息，请参阅 AuthenticationLevel 枚举。

类型:	AuthenticationLevel
接受的值:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:	Named
默认值:	Packet (enumerated value of 4)
必需:	False
接受管道输入:	False
接受通配符:	False

-BufferSize

指定使用此命令发送的缓冲区的大小（以字节为单位）。默认值为 32。

类型:	Int32
别名:	Size, Bytes, BS
Position:	Named
默认值:	32
必需:	False
接受管道输入:	False
接受通配符:	False

-ComputerName

指定要 ping 的计算机。键入计算机名称或以 IPv4 或 IPv6 格式键入 IP 地址。不允许使用通配符。此参数是必需的。

此参数不依赖于 PowerShell 远程处理。即使计算机未配置为运行远程命令，也可以使用 ComputerName 参数。

类型:	String[]
别名:	CN, IPAddress, __SERVER, Server, Destination
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Count

指定要发送的回显请求数。默认值为 4。

类型:	Int32
Position:	Named
默认值:	4
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

指定有权从源计算机发送 ping 请求的用户帐户。键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如 Get-Credential cmdlet 中的一个。

仅当命令中使用 Source 参数时，Credential 参数才有效。凭据不会影响目标计算机。

类型:	PSCredential
Position:	Named
默认值:	Current user
必需:	False
接受管道输入:	False
接受通配符:	False

-Delay

指定 ping 之间的间隔（以秒为单位）。

类型:	Int32
Position:	Named
默认值:	1 (second)
必需:	False
接受管道输入:	False
接受通配符:	False

-Impersonation

指定此 cmdlet 调用 WMI 时要使用的模拟级别。 Test-Connection 使用 WMI。

此参数的可接受值如下所示：

默认。默认模拟。
匿名。隐藏调用方的身份。
标识。允许对象查询调用方凭据。
模拟。允许对象使用调用方凭据。

默认值为模拟。

类型:	ImpersonationLevel
接受的值:	Default, Anonymous, Identify, Impersonate, Delegate
Position:	Named
默认值:	Impersonate
必需:	False
接受管道输入:	False
接受通配符:	False

-Quiet

Quiet 参数在 system.Boolean 对象中返回布尔值。使用此参数可禁止显示所有错误。

测试的每个连接都会返回布尔值。如果 ComputerName 参数指定多台计算机，则返回 布尔值 值的数组。

如果任何 ping 成功，则返回 $True。

如果所有 ping 失败，则返回 $False。

类型:	SwitchParameter
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Source

指定 ping 源自的计算机的名称。输入以逗号分隔的计算机名称列表。默认值为本地计算机。

类型:	String[]
别名:	FCN, SRC
Position:	1
默认值:	Local computer
必需:	True
接受管道输入:	False
接受通配符:	False

-ThrottleLimit

指定可建立以运行此命令的最大并发连接数。如果省略此参数或输入值 0，则使用默认值 32。

限制限制仅适用于当前命令，不适用于会话或计算机。

类型:	Int32
Position:	Named
默认值:	32
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeToLive

指定数据包可以转发的最大时间。对于网关、路由器等中的每个跃点，TimeToLive 值将减少一个。在零时，将丢弃数据包并返回错误。在 Windows中，默认值为 128。 TimeToLive 参数的别名 TTL。

类型:	Int32
别名:	TTL
Position:	Named
默认值:	128 in Windows
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

无法通过管道将输入传递给此 cmdlet。

输出

ManagementObject

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

如果指定 Quiet 参数，则返回 布尔值 值。如果测试了多个连接，将返回 布尔值 值的数组。否则，Test-Connection 为每个 ping 返回 Win32_PingStatus 对象。

备注

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

PowerShell 3.0 中引入了源参数集。

通过