Test-NetConnection

项目
11/17/2015

Test-NetConnection

Displays diagnostic information for a connection.

语法

Parameter Set: CommonTCPPort
Test-NetConnection [[-ComputerName] <String> ] [-CommonTCPPort] <String> [-InformationLevel <String> ] [ <CommonParameters>]

Parameter Set: ICMP
Test-NetConnection [[-ComputerName] <String> ] [-Hops <Int32> ] [-InformationLevel <String> ] [-TraceRoute] [ <CommonParameters>]

Parameter Set: RemotePort
Test-NetConnection [[-ComputerName] <String> ] -Port <Int32> [-InformationLevel <String> ] [ <CommonParameters>]

详细说明

The Test-NetConnection cmdlet displays diagnostic information for a connection. The output includes the results of a DNS lookup, a listing of IP interfaces, an option to test a TCP connection, IPsec rules, and confirmation of connection establishment.

参数

-CommonTCPPort<String>

Specifies the common service TCP port number. 此参数可接受的值如下：

-- SMB
-- HTTP
-- RDP
-- PING

别名	无
是否为必需？	true
位置？	2
默认值	无
是否接受管道输入？	false
是否接受通配符？	false

-ComputerName<String>

Specifies the Domain Name System (DNS) name or IP address of the target computer that runs the Dynamic Host Configuration Protocol (DHCP) server service.

别名	RemoteAddress,cn
是否为必需？	false
位置？	1
默认值	无
是否接受管道输入？	True (ByValue, ByPropertyName)
是否接受通配符？	false

-Hops<Int32>

Specifies the number of hops to traverse in a trace route command.

别名	无
是否为必需？	false
位置？	named
默认值	无
是否接受管道输入？	false
是否接受通配符？	false

-InformationLevel<String>

Specifies the information level. 此参数可接受的值如下：

-- Detailed
-- Quiet

If you set this parameter to Quiet, the cmdlet returns a Boolean value that indicates if the attempt to ping a host or port succeeded.

别名	无
是否为必需？	false
位置？	named
默认值	无
是否接受管道输入？	false
是否接受通配符？	false

-Port<Int32>

Specifies the TCP port number on the remote computer. The cmdlet uses this port number to test connectivity to the remote machine.

别名	RemotePort
是否为必需？	true
位置？	named
默认值	无
是否接受管道输入？	True (ByPropertyName)
是否接受通配符？	false

-TraceRoute

Indicates that Tracert runs to test connectivity to the remote host.

别名	无
是否为必需？	false
位置？	named
默认值	无
是否接受管道输入？	false
是否接受通配符？	false

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

输入

输入类型是指可通过管道传送给 cmdlet 的对象的类型。

none

输出

输出类型是 cmdlet 所发出对象的类型。

NetConnectionResults

Results of the connectivity test to the specified computer name

示例

Example 1: Test a connection

This command tests a network connection.

PS C:\> Test-NetConnection

Example 2: Test a connection and display detailed results

This command tests a network connection and sets the InformationLevel parameter to Detailed.

PS C:\> Test-NetConnection -Port 80 -InformationLevel Detailed

Example 3: Test a connection to a remote host

This command tests a network connection to a remote host named www.contoso.com.

PS C:\> Test-NetConnection -ComputerName www.contoso.com -InformationLevel Detailed

Test-NetConnection