Test-NetConnection

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>

Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Входные данные

Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.

• none

Выходные данные

Тип выходных данных — это тип объектов, которые выдает командлет.

• 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