Test-Connection
将 ICMP 回显请求数据包或 ping 发送给一台或多台计算机。
语法
Test-Connection
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-BufferSize <Int32>]
[-ComputerName] <String[]>
[-Count <Int32>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-TimeToLive <Int32>]
[-Delay <Int32>]
[<CommonParameters>]
Test-Connection
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-BufferSize <Int32>]
[-ComputerName] <String[]>
[-Count <Int32>]
[-Credential <PSCredential>]
[-Source] <String[]>
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-TimeToLive <Int32>]
[-Delay <Int32>]
[<CommonParameters>]
Test-Connection
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-BufferSize <Int32>]
[-ComputerName] <String[]>
[-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
使用 ComputerName 参数指定 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 操作的用户帐户,并使用 Impersonation 参数将模拟级别更改为“Identify”。
示例 7:仅当连接测试成功时创建会话
仅当发送到 Server01 计算机上的至少一条 ping 成功时,此示例才会在该计算机上创建一个会话。
if (Test-Connection -ComputerName Server01 -Quiet) {New-PSSession Server01}
if
命令使用 Test-Connection
cmdlet 对 Server01 计算机执行 ping 操作。 该命令使用 Quiet 参数,这样将返回一个布尔值,而不是 Win32_PingStatus 对象。 如果这四条 ping 中有任何 ping 成功,则该返回值为 $True
,否则为 $False
。
如果 Test-Connection
命令返回 $True
值,则该命令将使用 New-PSSession
cmdlet 创建 PSSession。
参数
-AsJob
指示此 cmdlet 作为后台作业运行。 指定 AsJob 参数时,该命令立即返回代表后台作业的对象。 当作业完成时,你可以继续在此会话中工作。 若要获取作业结果,请使用 Receive-Job
cmdlet。
有关 PowerShell 后台作业的详细信息,请参阅 about_Jobs 和 about_Remote_Jobs。
类型: | SwitchParameter |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-BufferSize
指定使用此命令发送的缓冲区的大小,以字节为单位。 默认值为 32。
类型: | Int32 |
别名: | Size, Bytes, BS |
Position: | Named |
默认值: | 32 |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ComputerName
指定要对其执行 ping 操作的计算机。 请键入计算机名称或者以 IPv4 或 IPv6 格式键入 IP 地址。 不允许使用通配符。 此参数是必需的。
此参数不依赖于 PowerShell 远程处理。 即使计算机未配置为运行远程命令,也可以使用 ComputerName 参数。
注意
在 PowerShell 6.0 及更高版本中,ComputerName 参数重命名为 TargetName。
类型: | 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 的一个 PSCredential 对象。
仅当该命令中使用了 Source 参数时,Credential 参数才有效。 这些凭据不会影响目标计算机。
类型: | PSCredential |
Position: | Named |
默认值: | Current user |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DcomAuthentication
指定此 cmdlet 用于 WMI 的身份验证级别。
Test-Connection
使用 WMI。
此参数的可接受值为:
- 默认。 Windows 身份验证
- 无。 无 COM 身份验证
- 连接。 连接级 COM 身份验证
- Call。 调用级 COM 身份验证
- Packet。 数据包级 COM 身份验证
- PacketIntegrity。 数据包完整性级 COM 身份验证
- PacketPrivacy。 数据包隐私级 COM 身份验证
- Unchanged。 与前一个命令相同
默认值为 Packet,其枚举值为 4。 有关此参数的值的详细信息,请参阅 AuthenticationLevel 枚举。
类型: | AuthenticationLevel |
别名: | Authentication |
接受的值: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
Position: | Named |
默认值: | Packet (enumerated value of 4) |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Delay
指定两次 ping 操作之间的间隔时间,以秒为单位。
类型: | Int32 |
Position: | Named |
默认值: | 1 (second) |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Impersonation
指定此 cmdlet 调用 WMI 时使用的模拟级别。 Test-Connection
使用 WMI。
此参数的可接受值如下所示:
- 默认。 默认模拟。
- 匿名。 隐藏调用方的身份。
- Identify。 允许对象查询调用方的凭据。
- Impersonate。 允许对象使用调用方的凭据。
默认值为 Impersonate。
类型: | ImpersonationLevel |
接受的值: | Default, Anonymous, Identify, Impersonate, Delegate |
Position: | Named |
默认值: | Impersonate |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Protocol
指定协议。 此参数的可接受值为 DCOM 和 WSMan。
类型: | String |
接受的值: | DCOM, WSMan |
Position: | Named |
默认值: | None |
必需: | 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 值将减少 1。 为零时,将丢弃数据包并返回错误。 在 Windows 中,默认值为 128。 TimeToLive 参数的别名是 TTL。
类型: | Int32 |
别名: | TTL |
Position: | Named |
默认值: | 128 in Windows |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WsmanAuthentication
指定此 cmdlet 使用 WSMan 协议时用于对用户的凭据进行身份验证的机制。 此参数的可接受值为:
- 基本
- CredSSP
- 默认
- 摘要
- Kerberos
- Negotiate。
默认值为 Default。
有关此参数的值的详细信息,请参阅 AuthenticationMechanism 枚举。
注意:在凭据安全服务提供程序 (CredSSP) 身份验证中,用户凭据传递到远程计算机中以进行验证,这种验证用于要求对多个资源(例如访问远程网络共享)进行验证的命令。 此机制增加了远程操作的安全风险。 如果远程计算机的安全受到威胁,则传递给该计算机的凭据可用于控制网络会话。
已在 Windows PowerShell 3.0 中引入了此参数。
类型: | String |
接受的值: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
默认值: | Default |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
不能通过管道将对象传递给此 cmdlet。
输出
默认情况下,此 cmdlet 为每个 ping 答复返回一个 Win32_PingStatus 对象。
System.Management.Automation.RemotingJob
如果你指定 AsJob 参数,此 cmdlet 将返回作业对象。
使用 Quiet 参数时,它会返回一个布尔值。 如果 cmdlet 测试多个连接,它将返回一组布尔值。
备注
此 cmdlet 使用 Win32_PingStatus 类。 Get-WMIObject Win32_PingStatus
命令等效于 Test-Connection
命令。
在 PowerShell 3.0 中已经引入了 Source 参数集。