Test-Connection

Test-Connection
    [-TargetName] <string[]>
    [-Ping]
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-MaxHops <int>]
    [-Count <int>]
    [-Delay <int>]
    [-BufferSize <int>]
    [-DontFragment]
    [-Quiet]
    [-TimeoutSeconds <int>]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -Repeat
    [-Ping]
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-MaxHops <int>]
    [-Delay <int>]
    [-BufferSize <int>]
    [-DontFragment]
    [-Quiet]
    [-TimeoutSeconds <int>]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -Traceroute
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-MaxHops <int>]
    [-Quiet]
    [-TimeoutSeconds <int>]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -MtuSize
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Quiet]
    [-TimeoutSeconds <int>]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -TcpPort <int>
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-Count <int>]
    [-Delay <int>]
    [-Repeat]
    [-Quiet]
    [-TimeoutSeconds <int>]
    [-Detailed]
    [<CommonParameters>]

L’applet de commande Test-Connection envoie des paquets de demande d’écho ICMP (Internet Control Message Protocol) ou des pings à un ou plusieurs ordinateurs distants et retourne les réponses de réponse d’écho. Vous pouvez utiliser cette applet de commande pour déterminer si un ordinateur particulier peut être contacté sur un réseau IP.

Vous pouvez utiliser les paramètres de Test-Connection pour spécifier à la fois les ordinateurs d’envoi et de réception, pour exécuter la commande en tant que travail en arrière-plan, définir un délai d’attente et un nombre de pings et configurer la connexion et l’authentification.

Contrairement à la commande ping familière, retourne un objet TestConnectionCommand+PingStatus que vous pouvez examiner dans PowerShell. Le paramètre Quiet renvoie une valeur Boolean dans un objet System.Boolean pour chaque connexion testée. Si plusieurs connexions sont testées, un tableau de valeurs booléennes est retourné.

Cet exemple envoie des paquets de demande d’écho de l’ordinateur local à l’ordinateur Server01.

Test-Connection -TargetName Server01 -IPv4

   Destination: Server01

Ping Source           Address                   Latency BufferSize Status
                                                   (ms)        (B)
---- ------           -------                   ------- ---------- ------
   1 ADMIN1           10.59.137.44                   24         32 Success
   2 ADMIN1           10.59.137.44                   39         32 Success
   3 ADMIN1           *                               *          * TimedOut
   4 ADMIN1           10.59.137.44                   28         32 Success

Test-Connection utilise le paramètre TargetName pour spécifier l’ordinateur Server01. Le paramètre IPv4 spécifie le protocole pour le test.

Une série d’objets TestConnectionCommand+PingStatus sont envoyés au flux de sortie, un objet par réponse ping à partir de l’ordinateur cible.

Cet exemple envoie des pings de l’ordinateur local à plusieurs ordinateurs distants.

Test-Connection -TargetName Server01, Server02, Server12

Cet exemple utilise les paramètres de Test-Connection pour personnaliser la commande. L’ordinateur local envoie un test ping à un ordinateur distant.

Test-Connection -TargetName Server01 -Count 3 -Delay 2 -MaxHops 255 -BufferSize 256

Test-Connection utilise le paramètre TargetName pour spécifier Server01. Le paramètre Count spécifie que trois pings sont envoyés à l’ordinateur Server01 avec un délai de 2 secondes.

Vous pouvez utiliser ces options lorsque la réponse ping est censée prendre plus de temps que d’habitude, soit en raison d’un nombre étendu de tronçons ou d’une condition réseau à trafic élevé.

Cet exemple montre comment exécuter une commande Test-Connection en tant que travail en arrière-plan PowerShell.

$job = Start-Job -ScriptBlock { Test-Connection -TargetName (Get-Content -Path "Servers.txt") }
$Results = Receive-Job $job -Wait

La commande Start-Job utilise l’applet de commande Test-Connection pour effectuer un test ping sur de nombreux ordinateurs d’une entreprise. La valeur du paramètre TargetName est une commande qui lit une liste de noms d’ordinateurs à partir du fichier . La commande utilise l’applet de commande Start-Job pour exécuter la commande en tant que travail en arrière-plan et enregistre le travail dans la variable $job.

La commande Receive-Job est spécifiée pour -Wait jusqu’à ce que le travail soit terminé, puis obtient les résultats et les stocke dans la variable $Results.

Cet exemple crée une session sur l’ordinateur Server01 uniquement si au moins un des pings envoyés à l’ordinateur réussit.

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

L’applet de commande Test-Connection effectue un test ping sur l’ordinateur Server01, avec le paramètre Silencieux fourni. La valeur résultante est $true si l’un des quatre pings réussit. Si aucune des commandes ping ne réussit, la valeur est $false.

Si la commande Test-Connection retourne une valeur de $true, la commande utilise l’applet de commande New-PSSession pour créer la session PS .

Introduit dans PowerShell 6.0, le paramètre TraceRoute mappe un itinéraire entre l’ordinateur local et la destination distante que vous spécifiez avec le paramètre TargetName.

Test-Connection -TargetName www.google.com -Traceroute

   Target: google.com

Hop Hostname                  Ping Latency Status           Source       TargetAddress
                                      (ms)
--- --------                  ---- ------- ------           ------       -------------
  1 172.20.0.1                   1       4 Success          Lira         172.217.9.174
  1 172.20.0.1                   2       3 Success          Lira         172.217.9.174
  1 172.20.0.1                   3       2 Success          Lira         172.217.9.174
  2 12.108.153.193               1       3 Success          Lira         172.217.9.174
  2 12.108.153.193               2       3 Success          Lira         172.217.9.174
  2 12.108.153.193               3       2 Success          Lira         172.217.9.174
  3 12.244.85.177                1      11 Success          Lira         172.217.9.174
  3 12.244.85.177                2      12 Success          Lira         172.217.9.174
  3 12.244.85.177                3      12 Success          Lira         172.217.9.174
  4 *                            1      14 DestinationNetw… Lira         172.217.9.174
  4 *                            2       * TimedOut         Lira         172.217.9.174
  4 *                            3      20 DestinationNetw… Lira         172.217.9.174
  5 *                            1       * TimedOut         Lira         172.217.9.174
  5 *                            2      15 DestinationNetw… Lira         172.217.9.174
  5 *                            3       * TimedOut         Lira         172.217.9.174
  6 *                            1      18 DestinationNetw… Lira         172.217.9.174
  6 *                            2       * TimedOut         Lira         172.217.9.174
  6 *                            3      16 DestinationNetw… Lira         172.217.9.174
  7 *                            1       * TimedOut         Lira         172.217.9.174
  7 *                            2       * TimedOut         Lira         172.217.9.174
  7 *                            3       * TimedOut         Lira         172.217.9.174
  8 *                            1       * TimedOut         Lira         172.217.9.174
  8 *                            2       * TimedOut         Lira         172.217.9.174
  8 *                            3       * TimedOut         Lira         172.217.9.174
  9 *                            1       * TimedOut         Lira         172.217.9.174
  9 *                            2       * TimedOut         Lira         172.217.9.174
  9 *                            3       * TimedOut         Lira         172.217.9.174
 10 *                            1       * TimedOut         Lira         172.217.9.174
 10 *                            2       * TimedOut         Lira         172.217.9.174
 10 *                            3       * TimedOut         Lira         172.217.9.174
 11 172.217.9.174                1      23 Success          Lira         172.217.9.174
 11 172.217.9.174                2      21 Success          Lira         172.217.9.174
 11 172.217.9.174                3      22 Success          Lira         172.217.9.174

La commande Test-Connection est appelée avec le paramètre Traceroute. Les résultats, qui sont des objets [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus], sont envoyés dans le flux de sortie Success.

Lorsque vous utilisez le paramètre détaillé, cette applet de commande retourne des informations détaillées sur l’état des tentatives de connexion TCP.

Test-Connection bing.com -TCPPort 443 -Detailed -Count 4

   Target: bing.com

Id Source     Address           Port Latency(ms) Connected Status
-- ------     -------           ---- ----------- --------- ------
 1 circumflex 2620:1ec:c11::200  443          12 True      Success
 2 circumflex 2620:1ec:c11::200  443          14 True      Success
 3 circumflex 2620:1ec:c11::200  443          17 True      Success
 4 circumflex 2620:1ec:c11::200  443          17 True      Success

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Par défaut, cette applet de commande retourne un objet TestConnectionCommand+PingStatus pour chaque réponse ping.

Lorsque vous utilisez le paramètre TraceRoute , cette applet de commande renvoie un objet TestConnectionCommand+TraceStatus pour chaque réponse ping le long de l’itinéraire.

Lorsque vous utilisez les paramètres Quiet ou TcpPort, cette applet de commande renvoie une valeur booléenne. Si l’applet de commande teste plusieurs connexions, elle retourne un tableau de valeurs booléennes.

Lorsque vous utilisez le paramètre MtuSize, cette applet de commande renvoie un objet TestConnectionCommand+PingMtuStatus pour chaque réponse ping.

Lorsque vous utilisez le paramètre détaillé, cette cmdlet renvoie un objet TestConnectionCommand+TcpPortStatus indiquant l’état de la connexion TCP.

Sur Linux, l’utilisation du paramètre BufferSize ou toute combinaison de paramètres avec le jeu de paramètres MtuSize qui entraîne une taille de mémoire tampon autre que celle par défaut de 32 octets peut nécessiter sudo. Dans ce cas, Test-Command déclenche une exception avec un message indiquant que sudo est nécessaire.