Test-Connection

Test-Connection [-ComputerName] <string[]> [[-Source] <string[]>] [-AsJob] [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-BufferSize <int>] [-Count <int>] [-Credential <PSCredential>] [-Delay <int>] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Quiet] [-ThrottleLimit <int>] [-TimeToLive <int>] [<CommonParameters>]

C:\PS>test-connection server01

Source        Destination     IPV4Address     IPV6Address  Bytes    Time(ms)
------        -----------     -----------     -----------  -----    --------
ADMIN1        Server01        157.59.137.44                32       0
ADMIN1        Server01        157.59.137.44                32       0
ADMIN1        Server01        157.59.137.44                32       0
ADMIN1        Server01        157.59.137.44                32       1

Descrição
-----------
Esse comando envia pacotes de solicitação de eco ("pings") do computador local para o computador Server01. O comando usa o parâmetro ComputerName para especificar o computador Server01, mas omite o nome opcional do parâmetro.

C:\PS>test-connection -computername server01, server02, server12 -credential domain01\user01

Descrição
-----------
Esse comando envia pacotes de solicitação de eco ("pings") do computador local para vários computadores remotos. Ele usa o parâmetro Credential para especificar uma conta de usuário que tem permissão para executar ping em todos os computadores remotos.

C:\PS>test-connection -source Server02, Server 12, localhost -computername Server01

Descrição
-----------
Esse comando envia pings de diferentes computadores de origem para um único computador remoto, Server01. Use esse formato de comando para testar a latência das conexões de vários pontos.

C:\PS>test-connection -computername Server01 -count 3 -delay 2 -TTL 256 -buffersize 256 -throttle 32

Descrição
-----------
Esse comando envia três pings do computador local para o computador Server01. Ele usa os parâmetros de Test-Connection para personalizar o comando.

Use esse formato de comando quando se esperar que a resposta do ping demore mais tempo do que o normal, devido a um número extenso de saltos ou ao excesso de tráfego na rede.

C:\PS>$job = test-connection -computername (get-content servers.txt) -asjob

C:\PS> if ($job.jobstateinfo.state -ne "Running") {$results = receive-job $job}

Descrição
-----------
Esse exemplo mostra como executar um comando Test-Connection como um trabalho em segundo plano do Windows PowerShell. 

O primeiro comando usa o cmdlet Test-Connection para executar ping em vários computadores na empresa. O valor do parâmetro ComputerName é um comando Get-Content que lê uma lista de nomes de computadores no arquivo Servers.txt. O comando usa o parâmetro AsJob para executar o comando como um trabalho em segundo plano.

O segundo comando verifica se o trabalho ainda não está sendo executado e, caso não esteja, usa um comando Receive-Job para obter os resultados e armazená-los na variável $results.

C:\PS>test-connection Server55 -credential domain55\user01 -impersonation Identify

Descrição
-----------
O comando usa o cmdlet Test-Connection para executar o ping em um computador local. O comando usa o parâmetro Credential para especificar uma conta de usuário com permissão para executar o ping no computador remoto e o parâmetro Impersonation para alterar o nível de representação para "Identify".

C:\PS>if (test-connection -computername Server01 -quiet) {new-pssession Server01}

Descrição
-----------
Esse comando criará uma PSSession no Server01 somente se pelo menos um dos pings enviados ao computador tiver sucesso.

O comando usa o cmdlet Test-Connection para executar ping no computador Server01. O comando usa o parâmetro Quiet que retorna um valor Booleano em vez de um objeto Win32_PingStatus. O valor será $True se quaisquer dos quatro pings tiver sucesso; caso contrário, será false.

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