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

Descripción
-----------
Este comando envía paquetes de solicitud de eco ("pings") del equipo local al equipo Server01. Utiliza el parámetro ComputerName para especificar el equipo Server01, pero omite el nombre de parámetro opcional.

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

Descripción
-----------
Este comando envía pings del equipo local a varios equipos remotos. Usa el parámetro Credential para especificar una cuenta de usuario con permiso para hacer ping a todos los equipos remotos.

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

Descripción
-----------
Este comando envía pings de equipos de orígenes diferentes a un solo equipo remoto, Servidor01. Utilice este formato de comando para probar la latencia de conexiones desde varios puntos.

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

Descripción
-----------
Este comando envía tres pings del equipo local al equipo Server01. Utiliza los parámetros de Test-Connection para personalizar el comando.

Utilice este formato de comando cuando se espere que la respuesta de ping va a tardar más tiempo de lo habitual, ya se deba a un número extendido de bucles o a una condición de alto tráfico de red.

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

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

Descripción
-----------
En este ejemplo se muestra la forma de ejecutar un comando Test-Connection como un trabajo en segundo plano de Windows PowerShell. 

El primer comando utiliza el cmdlet Test-Connection para hacer ping a muchos equipos de una empresa. El valor del parámetro ComputerName es un comando Get-Content que lee una lista de nombres de equipo del archivo Servers.txt. El comando utiliza el parámetro AsJob para ejecutar el comando como un trabajo en segundo plano.

El segundo comando comprueba si el trabajo no se está ejecutando todavía y, si no lo está, utiliza un comando Receive-Job para obtener los resultados y almacenarlos en la variable $results.

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

Descripción
-----------
Este comando utiliza el cmdlet Test-Connection para hacer ping a un equipo remoto. El comando utiliza el parámetro Credential para especificar una cuenta de usuario con permiso para hacer ping al equipo remoto y el parámetro Impersonation para cambiar el nivel de suplantación a "Identify".

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

Descripción
-----------
Este comando solo crea PSSession en el Servidor01 si al menos uno de los pings enviados al equipo es correcto.

El comando utiliza el cmdlet Test-Connection para hacer ping al equipo Servidor01. El comando utiliza el parámetro Quiet, que devuelve un valor booleano, en lugar de un objeto Win32_PingStatus. El valor es $True si cualquiera de los cuatro pings es correcto; de lo contrario, es falso.

Si el comando Test-Connection devuelve un valor de $True, el comando utiliza el cmdlet New-PSSession para crear la PSSession.