Test-NetConnection

Test-NetConnection

Displays diagnostic information for a connection.

Sintaxe

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>]

Descrição detalhada

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.

Parâmetros

-CommonTCPPort<String>

Specifies the common service TCP port number. Os valores aceitáveis para este parâmetro são:

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

Aliases	nenhuma
Necessário?	true
Posição?	2
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	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.

Aliases	RemoteAddress,cn
Necessário?	false
Posição?	1
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByValue, ByPropertyName)
Aceitar caracteres curinga?	false

-Hops<Int32>

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

Aliases	nenhuma
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-InformationLevel<String>

Specifies the information level. Os valores aceitáveis para este parâmetro são:

-- 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.

Aliases	nenhuma
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	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.

Aliases	RemotePort
Necessário?	true
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByPropertyName)
Aceitar caracteres curinga?	false

-TraceRoute

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

Aliases	nenhuma
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet dá suporte a parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet.

• none

Saídas

O tipo de saída é o tipo de objeto emitido pelo cmdlet.

• NetConnectionResults

  Results of the connectivity test to the specified computer name

Exemplos

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