Test-Connection

Test-Connection
    [-ComputerName] <String[]>
    [-AsJob]
    [-Authentication <AuthenticationLevel>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Test-Connection
    [-ComputerName] <String[]>
    [-Source] <String[]>
    [-AsJob]
    [-Authentication <AuthenticationLevel>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Credential <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Test-Connection
    [-ComputerName] <String[]>
    [-Authentication <AuthenticationLevel>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [-Quiet]
    [<CommonParameters>]

O cmdlet Test-Connection envia pacotes de solicitação de eco ICMP (Internet Control Message Protocol), ou pings, para um ou mais computadores remotos e retorna as respostas de eco. Você pode usar esse cmdlet para determinar se um determinado computador pode ser contatado através de uma rede IP.

Você pode usar os parâmetros de Test-Connection para especificar os computadores de envio e de recebimento, para executar o comando como um trabalho em segundo plano, para definir um tempo limite e um número de pings e para configurar a conexão e a autenticação.

Ao contrário do conhecido comando ping , retorna um objeto Win32_PingStatus que você pode investigar no PowerShell. O parâmetro Quiet retorna um valor booleano em um objeto System.Boolean para cada conexão testada. Se várias conexões forem testadas, uma matriz de valores booleanos de será retornada.

Este exemplo envia pacotes de solicitação de eco do computador local para o computador 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 usa o parâmetro ComputerName para especificar o computador Server01.

Este exemplo envia pings do computador local para vários computadores remotos.

Test-Connection -ComputerName Server01, Server02, Server12

Este exemplo envia pings de computadores de origem diferentes para um único computador remoto, Server01.

Test-Connection -Source Server02, Server12, localhost -ComputerName Server01 -Credential Domain01\Admin01

Test-Connection usa o parâmetro Credential para especificar as credenciais de um usuário que tem permissão para enviar uma solicitação ping dos computadores de origem. Use este formato de comando para testar a latência de conexões de vários pontos.

Este exemplo usa os parâmetros de Test-Connection para personalizar o comando. O computador local envia um teste de ping para um computador remoto.

Test-Connection -ComputerName Server01 -Count 3 -Delay 2 -TTL 255 -BufferSize 256 -ThrottleLimit 32

Test-Connection usa o parâmetro TargetName para especificar Server01. O parâmetro Count especifica que três pings são enviados para o computador Server01 com um atraso de intervalos de 2 segundos.

Você pode usar essas opções quando se espera que a resposta de ping demore mais do que o normal, devido a um número estendido de saltos ou a uma condição de rede de alto tráfego.

Este exemplo mostra como executar um comando Test-Connection como um trabalho em segundo plano do PowerShell.

$job = Test-Connection -ComputerName (Get-Content Servers.txt) -AsJob
if ($job.JobStateInfo.State -ne "Running") {$Results = Receive-Job $job}

O comando Test-Connection pings muitos computadores em uma empresa. O valor do parâmetro ComputerName é um comando Get-Content que lê uma lista de nomes de computadores do Servers.txt file. O comando usa o parâmetro AsJob para executar o comando como um trabalho em segundo plano e salva o trabalho na variável $job.

O comando if verifica se o trabalho ainda não está em execução. Se o trabalho não estiver em execução, Receive-Job obtém os resultados e os armazena na variável $Results.

Este comando usa o cmdlet Test-Connection para executar ping em um computador remoto.

Test-Connection Server55 -Credential Domain55\User01 -Impersonation Identify

O comando usa o parâmetro Credential para especificar uma conta de usuário que tenha permissão para executar ping no computador remoto e o parâmetro Impersonation para alterar o nível de representação para Identify.

Este exemplo cria uma sessão no computador Server01 somente se pelo menos um dos pings enviados para o computador for bem-sucedido.

if (Test-Connection -ComputerName Server01 -Quiet) {New-PSSession Server01}

O comando if usa o cmdlet Test-Connection para executar ping no computador Server01. O comando usa o parâmetro Quiet, que retorna um valor de booleano , em vez de um objeto Win32_PingStatus. O valor é $True se qualquer um dos quatro pings for bem-sucedido e for, caso contrário, $False.

Se o comando Test-Connection retornar um valor de $True, o comando usará o cmdlet New-PSSession para criar o PSSession.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Não é possível canalizar a entrada para este cmdlet.

Este cmdlet retorna um objeto de trabalho, se você especificar o parâmetro AsJob.

Se você especificar o parâmetro Quiet, ele retornará um valor Boolean. Se várias conexões forem testadas, uma matriz de valores booleanos de será retornada. Caso contrário, Test-Connection retorna um objeto Win32_PingStatus para cada ping.

Este cmdlet usa a classe Win32_PingStatus. Um comando Get-WMIObject Win32_PingStatus é equivalente a um comando Test-Connection.

O conjunto de parâmetros Source foi introduzido no PowerShell 3.0.