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