Partager via

Test-Connection

  • Référence
Module:
Microsoft.PowerShell.Management

Envoie des paquets de demande d’écho ICMP, ou des pings, à un ou plusieurs ordinateurs.

Syntaxe

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

Description

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 silencieux retourne une valeur de booléenne dans un objet System.Boolean pour chaque connexion testée. Si plusieurs connexions sont testées, un tableau de valeurs booléennes est retourné.

Exemples

Exemple 1 : Envoyer des demandes d’écho à un ordinateur distant

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.

Exemple 2 : Envoyer des demandes d’écho à plusieurs ordinateurs

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

Test-Connection -TargetName Server01, Server02, Server12

Exemple 3 : Utiliser des paramètres pour personnaliser la commande de test

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

Exemple 4 : Exécuter un test en tant que travail en arrière-plan

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.

Exemple 5 : Créer une session uniquement si un test de connexion réussit

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 effectue un test ping sur l’ordinateur , 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 retourne une valeur de , la commande utilise l’applet de commande pour créer lePSSession .

Exemple 6 : Utiliser le paramètre TraceRoute

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 est appelée avec le paramètre traceroute . Les résultats, qui sont des objets [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus], sont générés dans le flux de sortie Success.

Paramètres

-BufferSize

Spécifie la taille, en octets, de la mémoire tampon envoyée avec cette commande. La valeur par défaut est 32.

Type:Int32
Alias:Size, Bytes, BS
Position:Named
Valeur par défaut:32
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Count

Spécifie le nombre de demandes d’écho à envoyer. La valeur par défaut est 4.

Type:Int32
Position:Named
Valeur par défaut:4
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Delay

Spécifie l’intervalle entre les pings, en secondes.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DontFragment

Ce paramètre définit l’indicateur Ne pas fragmenter dans l’en-tête IP. Vous pouvez utiliser ce paramètre avec le paramètre BufferSize pour tester la taille MTU path. Pour plus d’informations sur Path MTU, consultez l’article Path MTU Discovery dans wikipédia.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IPv4

Force l’applet de commande à utiliser le protocole IPv4 pour le test.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IPv6

Force l’applet de commande à utiliser le protocole IPv6 pour le test.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxHops

Définit le nombre maximal de tronçons qu’un message de demande ICMP peut être envoyé. La valeur par défaut est contrôlée par le système d’exploitation. La valeur par défaut pour Windows 10 et versions ultérieures est de 128 tronçons.

Type:Int32
Alias:Ttl, TimeToLive, Hops
Position:Named
Valeur par défaut:128
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MtuSize

Ce paramètre est utilisé pour découvrir la taille MTU du chemin d’accès. L’applet de commande retourne un objet PingReply#MTUSize qui contient la taille MTU Path vers la cible. Pour plus d’informations sur Path MTU, consultez l’article Path MTU Discovery dans wikipédia.

Type:SwitchParameter
Alias:MtuSizeDetect
Position:Named
Valeur par défaut:False
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Ping

Provoque l’exécution d’un test ping par l’applet de commande. Il s’agit du mode par défaut de l’applet de commande Test-Connection.

Type:SwitchParameter
Position:Named
Valeur par défaut:True
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Quiet

Le paramètre Quiet retourne une valeur de booléenne . L’utilisation de ce paramètre supprime toutes les erreurs.

Chaque connexion testée retourne une valeur booléenne. Si le paramètre TargetName spécifie plusieurs ordinateurs, un tableau de valeurs booléennes est retourné.

Si ping sur une cible donnée réussit, $True est retourné.

Si toutes les ping sur une cible donnée échouent, $False est retournée.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Repeat

Provoque l’envoi continu de requêtes ping à l’applet de commande. Ce paramètre ne peut pas être utilisé avec le paramètre count .

Type:SwitchParameter
Alias:Continuous
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResolveDestination

Provoque la tentative de résolution du nom DNS de la cible par l’applet de commande. Lorsqu’ils sont utilisés conjointement avec le paramètre traceroute , les noms DNS de tous les hôtes intermédiaires sont également récupérés, si possible.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Source

Spécifie les noms des ordinateurs où provient le test ping. Entrez une liste séparée par des virgules des noms d’ordinateurs. La valeur par défaut est l’ordinateur local.

Note

Ce paramètre n’est pas pris en charge dans les versions 6 et ultérieures de PowerShell. L’approvisionnement de ce paramètre provoque une erreur.

Type:String
Position:Named
Valeur par défaut:Local computer
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TargetName

Spécifie le ou les ordinateurs à tester. Tapez les noms d’ordinateurs ou tapez des adresses IP au format IPv4 ou IPv6.

Type:String[]
Alias:ComputerName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-TcpPort

Spécifie le numéro de port TCP sur la cible à utiliser dans le test de connexion TCP. L’applet de commande tente d’établir une connexion TCP au port spécifié sur la cible.

Si une connexion peut être établie, $True est retournée.

Si une connexion ne peut pas être établie, $False est retournée.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSeconds

Définit la valeur de délai d’expiration du test. Le test échoue si une réponse n’est pas reçue avant l’expiration du délai d’expiration. La valeur par défaut est de cinq secondes.

Ce paramètre a été introduit dans PowerShell 6.0.

Type:Int32
Position:Named
Valeur par défaut:5 seconds
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Traceroute

Provoque l’exécution d’un test traceroute par l’applet de commande. Lorsque ce paramètre est utilisé, l’applet de commande retourne un objet TestConnectionCommand+TraceStatus.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

TestConnectionCommand+PingStatus, TestConnectionCommand+TraceStatus, Boolean, TestConnectionCommand+PingMtuStatus

Par défaut, Test-Connection retourne un objet TestConnectionCommand+PingStatus pour chaque réponse ping.

Si vous spécifiez le paramètre TraceRoute, l’applet de commande retourne un objet TestConnectionCommand+TraceStatus pour chaque réponse ping le long de l’itinéraire.

Si vous spécifiez les paramètres quiet ou TcpPort, il retourne une valeur booléenne. Si plusieurs connexions sont testées, un tableau de valeurs booléennes est retourné.