Share via

Test-Connection

  • Referentie
Module:
Microsoft.PowerShell.Management

Verzendt ICMP-echoaanvraagpakketten, of pings, naar een of meer computers.

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

De Test-Connection cmdlet verzendt ICMP-echoaanvraagpakketten (Internet Control Message Protocol) of pings naar een of meer externe computers en retourneert de antwoorden van de echoreacties. U kunt deze cmdlet gebruiken om te bepalen of via een IP-netwerk verbinding kan worden gemaakt met een bepaalde computer.

U kunt de parameters van Test-Connection gebruiken om zowel de verzendende als de ontvangende computers op te geven, om de opdracht uit te voeren als achtergrondtaak, om een time-out en het aantal pings in te stellen en om de verbinding en verificatie te configureren.

In tegenstelling tot de vertrouwde pingopdracht retourneert Test-Connection een TestConnectionCommand+PingStatus-object dat u in PowerShell kunt onderzoeken. De parameter Quiet retourneert een Booleaanse waarde in een System.Boolean-object voor elke geteste verbinding. Als er meerdere verbindingen worden getest, wordt een matrix met Booleaanse waarden geretourneerd.

Voorbeelden

Voorbeeld 1: echoaanvragen verzenden naar een externe computer

In dit voorbeeld worden echoaanvraagpakketten van de lokale computer naar de Server01-computer verzonden.

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 gebruikt de parameter TargetName om de Server01-computer op te geven. Met de parameter IPv4 wordt het protocol voor de test opgegeven.

Een reeks TestConnectionCommand+PingStatus-objecten wordt verzonden naar de uitvoerstroom, één object per pingantwoord van de doelcomputer.

Voorbeeld 2: echoaanvragen verzenden naar meerdere computers

In dit voorbeeld worden pings van de lokale computer naar verschillende externe computers verzonden.

Test-Connection -TargetName Server01, Server02, Server12

Voorbeeld 3: Parameters gebruiken om de testopdracht aan te passen

In dit voorbeeld worden de parameters van gebruikt Test-Connection om de opdracht aan te passen. De lokale computer verzendt een pingtest naar een externe computer.

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

Test-Connection gebruikt de parameter TargetName om Server01 op te geven. De parameter Count geeft aan dat er drie pings worden verzonden naar de Server01-computer met een vertraging van 2 seconden.

U kunt deze opties gebruiken wanneer het ping-antwoord naar verwachting langer duurt dan normaal, vanwege een uitgebreid aantal hops of een netwerkvoorwaarde met veel verkeer.

Voorbeeld 4: Een test uitvoeren als achtergrondtaak

In dit voorbeeld ziet u hoe u een Test-Connection opdracht uitvoert als een PowerShell-achtergrondtaak.

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

De Start-Job opdracht gebruikt de Test-Connection cmdlet om veel computers in een onderneming te pingen. De waarde van de parameter TargetName is een Get-Content opdracht waarmee een lijst met computernamen uit het Servers.txt bestand wordt gelezen. De opdracht gebruikt de Start-Job cmdlet om de opdracht uit te voeren als een achtergrondtaak en slaat de taak op in de $job variabele.

De Receive-Job opdracht wordt geïnstrueerd totdat -Wait de taak is voltooid, waarna de resultaten worden opgehaald en opgeslagen in de $Results variabele.

Voorbeeld 5: een sessie alleen Creatie als een verbindingstest slaagt

In dit voorbeeld wordt alleen een sessie op de Server01-computer gemaakt als ten minste één van de pings die naar de computer worden verzonden, slaagt.

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

De Test-Connection cmdlet pingt de Server01 computer, met de parameter Quiet opgegeven. De resulterende waarde is $True als een van de vier pings slaagt. Als geen van de pings slaagt, is $Falsede waarde .

Als de Test-Connection opdracht een waarde van $Trueretourneert, gebruikt de opdracht de New-PSSession cmdlet om de PSSession te maken.

Voorbeeld 6: de traceroute-parameter gebruiken

De traceroute-parameter is geïntroduceerd in PowerShell 6.0 en wijst een route toe tussen de lokale computer en de externe bestemming die u opgeeft met de parameter 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

De Test-Connection opdracht wordt aangeroepen met de parameter Traceroute . De resultaten, die objecten zijn [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus] , worden uitgevoerd naar de uitvoerstroom Geslaagd .

Parameters

-BufferSize

Hiermee geeft u de grootte, in bytes, van de buffer verzonden met deze opdracht. De standaardwaarde is 32.

Type:Int32
Aliases:Size, Bytes, BS
Position:Named
Default value:32
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Count

Hiermee geeft u het aantal echoaanvragen te verzenden. De standaardwaarde is 4.

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

-Delay

Hiermee geeft u het interval tussen pings, in seconden.

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

-DontFragment

Met deze parameter wordt de vlag Niet fragment instellen in de IP-header. U kunt deze parameter gebruiken met de parameter BufferSize om de pad-MTU-grootte te testen. Zie het artikel Path MTU Discovery in Wikipedia voor meer informatie over Path MTU.

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

-IPv4

Hiermee dwingt u de cmdlet om het IPv4-protocol te gebruiken voor de test.

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

-IPv6

Hiermee dwingt u de cmdlet het IPv6-protocol te gebruiken voor de test.

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

-MaxHops

Hiermee stelt u het maximum aantal hops in dat een ICMP-aanvraagbericht kan worden verzonden. De standaardwaarde wordt bepaald door het besturingssysteem. De standaardwaarde voor Windows 10 en hoger is 128 hops.

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

-MtuSize

Deze parameter wordt gebruikt om de pad MTU-grootte te detecteren. De cmdlet retourneert een PingReply#MTUSize-object dat de pad-MTU-grootte naar het doel bevat. Zie het artikel Path MTU Discovery in Wikipedia voor meer informatie over Path MTU.

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

-Ping

Zorgt ervoor dat de cmdlet een ping-test uitvoert. Dit is de standaardmodus voor de Test-Connection cmdlet.

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

-Quiet

De parameter Quiet retourneert een Booleaanse waarde. Als u deze parameter gebruikt, worden alle fouten onderdrukt.

Elke verbinding die is getest, retourneert een Booleaanse waarde. Als de parameter TargetName meerdere computers opgeeft, wordt een matrix met Booleaanse waarden geretourneerd.

Als een ping naar een bepaald doel slaagt, $True wordt geretourneerd.

Als alle pings naar een bepaald doel mislukken, $False wordt geretourneerd.

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

-Repeat

Zorgt ervoor dat de cmdlet continu ping-aanvragen verzendt. Deze parameter kan niet worden gebruikt met de parameter Count .

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

-ResolveDestination

Zorgt ervoor dat de cmdlet probeert de DNS-naam van het doel om te lossen. Indien gebruikt in combinatie met de Traceroute parameter, worden de DNS-namen van alle tussenliggende hosts ook opgehaald, indien mogelijk.

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

-Source

Hiermee geeft u de namen van de computers waar de ping afkomstig is. Voer een door komma's gescheiden lijst met computernamen in. Standaard is dit de lokale computer.

Notitie

Deze parameter wordt niet ondersteund in PowerShell-versies 6 en hoger. Het opgeven van deze parameter veroorzaakt een fout.

Type:String
Position:Named
Default value:Local computer
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetName

Hiermee geeft u de computer(s) te testen. Typ de computernamen of typ IP-adressen in IPv4- of IPv6-indeling.

Type:String[]
Aliases:ComputerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TcpPort

Hiermee geeft u het TCP-poortnummer op het doel moet worden gebruikt in de TCP-verbindingstest. De cmdlet probeert een TCP-verbinding te maken met de opgegeven poort op het doel.

Als een verbinding kan worden gemaakt, $True wordt geretourneerd.

Als er geen verbinding kan worden gemaakt, $False wordt geretourneerd.

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

-TimeoutSeconds

Hiermee stelt u de time-outwaarde voor de test in. De test mislukt als er geen antwoord wordt ontvangen voordat de time-out is verlopen. De standaardwaarde is vijf seconden.

Deze parameter is geïntroduceerd in PowerShell 6.0.

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

-Traceroute

Zorgt ervoor dat de cmdlet een traceroute-test uitvoert. Wanneer deze parameter wordt gebruikt, retourneert de cmdlet een TestConnectionCommand+TraceStatus -object.

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

Invoerwaarden

None

U kunt geen invoer doorspezen naar deze cmdlet.

Uitvoerwaarden

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

Retourneert standaard Test-Connection een TestConnectionCommand+PingStatus-object voor elk pingantwoord.

Als u de traceroute parameter opgeeft, retourneert de cmdlet een TestConnectionCommand+TraceStatus-object voor elk pingantwoord langs de route.

Als u de parameters Quiet of TcpPort opgeeft, wordt een Booleaanse waarde geretourneerd. Als er meerdere verbindingen worden getest, wordt een matrix met Booleaanse waarden geretourneerd.