Test-Connection

ICMP echo kéréscsomagokat vagy pingeket küld egy vagy több számítógépre.

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

A Test-Connection parancsmag az Internet Control Message Protocol (ICMP) echo kéréscsomagjait vagy pingeit küldi egy vagy több távoli számítógépnek, és visszaadja az echo-válaszokat. Ezzel a parancsmaggal megállapíthatja, hogy egy adott számítógép kapcsolatba hozható-e egy IP-hálózaton keresztül.

A paraméterekkel megadhatja a küldő és fogadó számítógépeket Test-Connection , futtathatja a parancsot háttérfeladatként, időtúllépést és pingek számát állíthatja be, valamint konfigurálhatja a kapcsolatot és a hitelesítést.

A jól ismert ping parancstól eltérően egy TestConnectionCommand+PingStatus objektumot ad vissza, Test-Connection amelyet megvizsgálhat a PowerShellben. A Quiet paraméter logikai értéket ad vissza egy System.Boolean objektumban minden tesztelt kapcsolathoz. Ha több kapcsolatot tesztel, a rendszer logikai értékeket tartalmazó tömböt ad vissza.

Példák

1. példa: Echo-kérések küldése távoli számítógépre

Ez a példa echo kéréscsomagokat küld a helyi számítógépről a Server01 számítógépre.

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 uses the TargetName parameter to specify the Server01 computer. Az IPv4 paraméter határozza meg a teszt protokollát.

A rendszer egy sor TestConnectionCommand+PingStatus objektumot küld a kimeneti streambe, egy objektumot a célgép pingelési válaszánként.

2. példa: Echo-kérések küldése több számítógépre

Ez a példa pingeket küld a helyi számítógépről több távoli számítógépre.

Test-Connection -TargetName Server01, Server02, Server12

3. példa: Paraméterek használata a tesztparancs testreszabásához

Ez a példa a parancs testreszabásának Test-Connection paramétereit használja. A helyi számítógép pingelési tesztet küld egy távoli számítógépnek.

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

Test-Connection uses the TargetName parameter to specify Server01. A Count paraméter három pinget ad meg a Server01 számítógépnek 2 másodperces késleltetéssel .

Ezeket a beállításokat akkor használhatja, ha a pingelésre adott válasz várhatóan hosszabb időt vesz igénybe a szokásosnál, akár a hosszabb ugrások száma, akár a nagy forgalmú hálózati állapot miatt.

4. példa: Teszt futtatása háttérfeladatként

Ez a példa bemutatja, hogyan futtathat parancsokat Test-Connection PowerShell-háttérfeladatként.

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

A Start-Job parancs a Test-Connection parancsmaggal pingel egy vállalat számos számítógépét. A TargetName paraméter értéke egy Get-Content parancs, amely beolvassa a számítógépnevek listáját a Servers.txt fájlból. A parancs a Start-Job parancsmag használatával futtatja a parancsot háttérfeladatként, és menti a feladatot a $job változóba.

A Receive-Job parancs a feladat befejezéséig lesz utasítva -Wait , majd lekéri az eredményeket, és tárolja őket a $Results változóban.

5. példa: Csak akkor hozzon létre munkamenetet, ha egy kapcsolati teszt sikeres

Ez a példa csak akkor hoz létre munkamenetet a Server01 számítógépen, ha a számítógépre küldött pingek közül legalább egy sikeres.

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

A Test-Connection parancsmag pingeli a Server01 számítógépet a Quiet paraméterrel. Az eredmény az, $True ha a négy ping bármelyike sikeres. Ha egyik ping sem sikeres, az érték .$False

Ha a Test-Connection parancs egy értéket $Truead vissza, a parancs a New-PSSession parancsmagot használja a PSSession létrehozásához.

6. példa: A Traceroute paraméter használata

A PowerShell 6.0-ban bevezetett Traceroute paraméter a helyi számítógép és a TargetName paraméterrel megadott távoli cél közötti útvonalat képezi le.

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

A Test-Connection parancs a Traceroute paraméterrel van meghívva. Az eredmények, amelyek [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus] objektumok, a Success kimeneti adatfolyam kimenetei.

Paraméterek

-BufferSize

Az ezzel a paranccsal küldött puffer méretét adja meg bájtban. Az alapértelmezett érték 32.

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

-Count

Az elküldendő visszhangkérelmek számát adja meg. Az alapértelmezett érték a 4.

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

-Delay

A pingelések közötti időközt adja meg másodpercben.

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

-DontFragment

Ez a paraméter beállítja a Nem töredezettség jelzőt az IP-fejlécben. Ezt a paramétert a BufferSize paraméterrel használhatja a Path MTU méretének teszteléséhez. A Path MTU-ról további információt a Path MTU Discovery cikkében talál a Wikipédiában.

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

-IPv4

Kényszeríti a parancsmagot, hogy az IPv4 protokollt használja a teszthez.

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

-IPv6

Kényszeríti a parancsmagot, hogy az IPv6 protokollt használja a teszthez.

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

-MaxHops

Megadja, hogy az ICMP-kérések legfeljebb hány ugrást küldhetnek. Az alapértelmezett értéket az operációs rendszer vezérli. A Windows 10 és a magasabb értékek alapértelmezett értéke 128 ugrás.

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

-MtuSize

Ez a paraméter az elérési út MTU-méretének felderítésére szolgál. A parancsmag egy PingReply#MTUSize objektumot ad vissza, amely az Elérési út MTU-méretét tartalmazza a célhoz. A Path MTU-ról további információt a Path MTU Discovery cikkében talál a Wikipédiában.

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

-Ping

A parancsmag pingelési tesztet végez. Ez a parancsmag alapértelmezett módja Test-Connection .

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

-Quiet

A Quiet paraméter logikai értéket ad vissza. Ezzel a paraméterrel minden hiba el lesz rejtve.

Minden tesztelt kapcsolat logikai értéket ad vissza. Ha a TargetName paraméter több számítógépet határoz meg, a rendszer logikai értékeket tartalmazó tömböt ad vissza.

Ha egy adott cél pingelése sikeres, $True a rendszer visszaadja.

Ha egy adott cél összes pingelése sikertelen, $False a rendszer visszaadja.

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

-Repeat

A parancsmag folyamatosan pingelési kéréseket küld. Ez a paraméter nem használható a Count paraméterrel.

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

-ResolveDestination

A parancsmag megpróbálja feloldani a cél DNS-nevét. A Traceroute paraméterrel együtt használva a rendszer az összes köztes gazdagép DNS-nevét is lekéri, ha lehetséges.

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

-Source

Megadja azon számítógépek nevét, ahonnan a ping származik. Írja be a számítógépnevek vesszővel tagolt listáját. Alapértelmezés szerint a helyi számítógép.

Megjegyzés

Ez a paraméter a PowerShell 6-os és újabb verzióiban nem támogatott. A paraméter megadása hibát okoz.

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

-TargetName

Megadja a tesztelni kívánt számítógép(ek)et. Írja be a számítógépneveket, vagy írja be az IP-címeket IPv4 vagy IPv6 formátumban.

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

-TcpPort

Megadja a TCP-kapcsolati tesztben használni kívánt cél TCP-portszámát. A parancsmag MEGPRÓBÁL TCP-kapcsolatot létesíteni a cél megadott portjához.

Ha létre lehet hozni egy kapcsolatot, $True a rendszer visszaadja.

Ha nem lehet kapcsolatot létesíteni, $False a rendszer visszaadja.

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

-TimeoutSeconds

Beállítja a teszt időtúllépési értékét. A teszt meghiúsul, ha nem érkezik válasz az időtúllépés lejárta előtt. Az alapértelmezett érték öt másodperc.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

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

-Traceroute

A parancsmag nyomkövetési teszt végrehajtásához vezet. Ha ezt a paramétert használja, a parancsmag egy objektumot TestConnectionCommand+TraceStatus ad vissza.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet bemenő csövet adni.

Kimenetek

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

Alapértelmezés szerint Test-Connection minden pingválaszhoz egy TestConnectionCommand+PingStatus objektumot ad vissza.

Ha a Traceroute paramétert adja meg, a parancsmag egy TestConnectionCommand+TraceStatus objektumot ad vissza az útvonal minden pingválaszához.

Ha a Quiet vagy TcpPort paramétereket adja meg, az logikai értéket ad vissza. Ha több kapcsolatot tesztel, a rendszer logikai értékeket tartalmazó tömböt ad vissza.