Test-Connection

Référence

Module:: Microsoft.PowerShell.Management

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

Syntax

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 Test-Connection de commande envoie des paquets de demande d’écho ICMP (Internet Control Message Protocol), ou ping, à 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 permettant de Test-Connection spécifier à la fois les ordinateurs d’envoi et de réception, d’exécuter la commande en tant que travail en arrière-plan, de définir un délai d’attente et un nombre de tests ping, et de configurer la connexion et l’authentification.

Contrairement à la commande ping familière, Test-Connection retourne un objet TestConnectionCommand+PingStatus que vous pouvez examiner dans PowerShell. Le paramètre Quiet retourne une valeur 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 est envoyée 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 la commande 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 Test-Connection commande 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 Start-Job commande utilise l’applet de commande pour effectuer un Test-Connection test ping sur de nombreux ordinateurs d’une entreprise. La valeur du paramètre TargetName est une Get-Content commande qui lit une liste de noms d’ordinateurs à partir du Servers.txt fichier. La commande utilise l’applet Start-Job de commande pour exécuter la commande en tant que travail en arrière-plan et enregistre le travail dans la $job variable.

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

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 tests ping envoyés à l’ordinateur réussit.

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

L’applet Test-Connection de commande effectue un test ping sur l’ordinateur Server01 , avec le paramètre Quiet fourni. La valeur résultante est $True si l’un des quatre tests ping réussit. Si aucun des tests ping ne réussit, la valeur est $False.

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

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

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
Aliases:	Size, Bytes, BS
Position:	Named
Default value:	32
Accept pipeline input:	False
Accept wildcard characters:	False

-Count

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

Type:	Int32
Position:	Named
Default value:	4
Accept pipeline input:	False
Accept wildcard characters:	False

-Delay

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DontFragment

Ce paramètre définit l’indicateur Don’t Fragment 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 Découverte du chemin DTU dans wikipédia.

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv4

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv6

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	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 de Windows 10 et supérieure est de 128 tronçons.

Type:	Int32
Aliases:	Ttl, TimeToLive, Hops
Position:	Named
Default value:	128
Accept pipeline input:	False
Accept wildcard characters:	False

-MtuSize

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

Type:	SwitchParameter
Aliases:	MtuSizeDetect
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Ping

Entraîne l’envoi d’un test ping à l’applet de commande. Il s’agit du mode par défaut de l’applet de Test-Connection commande.

Type:	SwitchParameter
Position:	Named
Default value:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Quiet

Le paramètre Quiet retourne une valeur 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 un test ping sur une cible donnée réussit, $True est retourné.

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Repeat

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

Type:	SwitchParameter
Aliases:	Continuous
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResolveDestination

Entraîne 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
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

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

Notes

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
Default value:	Local computer
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetName

Spécifie le ou les ordinateurs à tester. Tapez le nom des ordinateurs ou les adresses IP au format IPv4 ou IPv6.

Type:	String[]
Aliases:	ComputerName
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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 elle est retournée.

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSeconds

Définit la valeur du délai d’expiration pour le 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 cinq secondes.

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

Type:	Int32
Position:	Named
Default value:	5 seconds
Accept pipeline input:	False
Accept wildcard characters:	False

-Traceroute

Entraîne l’opération d’un test traceroute par l’applet de commande. Lorsque ce paramètre est utilisé, l’applet de commande retourne un TestConnectionCommand+TraceStatus objet.

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	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 renvoie 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é.