Test-Connection

Modul:

Microsoft.PowerShell.Management Module

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

Syntax

DefaultPing (Alapértelmezett)

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

RepeatPing

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

MtuSizeDetect

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

TraceRoute

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

TcpPort

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

Description

A Test-Connection parancsmag elküldi az Internet Control Message Protocol (ICMP) visszhangkérelem-csomagjait vagy pingjeit egy vagy több távoli számítógépnek, és visszaadja a visszhangvá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 Test-Connection paramétereivel megadhatja a küldő és a fogadó számítógépeket, háttérfeladatként futtathatja a parancsot, 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 paranccsal ellentétben Test-Connection egy TestConnectionCommand+PingStatus objektumot ad vissza, amelyet a PowerShellben vizsgálhat. A Quiet paraméter egy logikai értéket ad vissza egy System.Boolean objektumban minden tesztelt kapcsolathoz. Több kapcsolat tesztelése esetén 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 a TargetName paraméterrel adja meg a Server01 számítógépet. Az IPv4 paraméter határozza meg a teszt protokollt.

A rendszer több TestConnectionCommand+PingStatus objektumot küld a kimeneti streambe, egy objektumot pingelésenként a célgéptől.

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 Test-Connection paramétereit használja a parancs testreszabásához. A helyi számítógép pingelési tesztet küld egy távoli számítógépre.

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

Test-Connection a TargetName paramétert használja a Server01 megadásához. A Count paraméter három ping elküldését határozza meg a Szerver01 számítógépre, késleltetéssel 2 másodperces időközönként.

Ezeket a beállításokat akkor használhatja, ha a pingelésre adott válasz várhatóan a szokásosnál hosszabb ideig tart, 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 egy Test-Connection parancsot 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 parancsmaggal futtatja a parancsot háttérfeladatként, és menti a feladatot a $job változóba.

A Receive-Job parancs utasítást kap, hogy hajtsa végre a -Wait feladatot a befejezéséig, majd a rendszer lekéri az eredményeket, és tárolja azokat 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ényként kapott érték $True, ha a négy ping bármelyike sikeres. Ha egyik ping sem sikerül, az érték $False.

Ha a Test-Connection parancs $Trueértéket ad vissza, a parancs a New-PSSession parancsmaggal hozza létre a PSSession.

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

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

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 meghívása a Traceroute paraméterrel történik. Az eredmények, amelyek [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus] objektumok, a Siker kimeneti adatfolyamba kerülnek.

Paraméterek

-BufferSize

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

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	32
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Méret, Bájt, hülyeség

Paraméterkészletek

DefaultPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

RepeatPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Count

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

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	4
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

DefaultPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Delay

A pingek közötti időközt adja meg másodpercben.

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

DefaultPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

RepeatPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-DontFragment

Ez a paraméter beállítja a Ne töredezz jelölőt az IP-fejlécben. Ezt a paramétert a BufferSize paraméterrel használhatja a Path MTU méretének teszteléséhez. További információ a Path MTU-ról: Path MTU Discovery cikk a Wikipédiában.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

DefaultPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

RepeatPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-IPv4

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-IPv6

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-MaxHops

Beállítja az ICMP-kérésüzenetek küldhető ugrásainak maximális számát. Az alapértelmezett értéket az operációs rendszer vezérli. A Windows 10 és újabb verziók alapértelmezett értéke 128 ugrás.

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	128
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Ttl, TimeToLive, Komlók

Paraméterkészletek

DefaultPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

RepeatPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

TraceRoute

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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 tartalmazza a cél elérési út MTU-méretét. További információ a Path MTU-ról: Path MTU Discovery cikk a Wikipédiában.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	MtuSizeDetect

Paraméterkészletek

MtuSizeDetect

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Ping

A parancsmag elvégzi a ping tesztet. Ez a Test-Connection parancsmag alapértelmezett módja.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	True
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

DefaultPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

RepeatPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Quiet

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

Minden tesztelt kapcsolat egy 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élhoz pingelése sikeres, $True lesz visszaadva.

Ha egy adott célhoz tartozó összes ping sikertelen, $False értéket ad vissza.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Repeat

A parancsmag folyamatosan pingelési kéréseket küld. Ha a TargetName értéke egy céltömb, a parancsmag csak az első cél pingelési kéréseit ismételje meg. Figyelmen kívül hagyja a fennmaradó célokat. Ez a paraméter nem használható a Darabszám paraméterrel.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Folyamatos

Paraméterkészletek

RepeatPing

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ResolveDestination

Arra készteti a parancsmagot, hogy megpróbálja feloldani a cél DNS-nevét. Ha a Traceroute paraméterrel együtt használják, az összes köztes állomás DNS-nevei is lekérhetők, ha lehetséges.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Source

Megadja azoknak a számítógépeknek a nevét, ahonnan a ping származik. Írja be a számítógépnevek vesszővel tagolt listáját. Az alapértelmezett beállítás a helyi számítógép.

Megjegyzés:

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

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	Local computer
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

DefaultPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

RepeatPing

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

TraceRoute

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

TcpPort

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Számítógépnév

Paraméterkészletek

(All)

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	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ával.

Ha kapcsolat létesíthető, akkor $True visszaadjuk.

Ha a kapcsolat nem sikerül, a $False rendszer visszaküldi.

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

TcpPort

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-TimeoutSeconds

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

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

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	5 seconds
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Traceroute

A cmdlet parancs nyomkövetési tesztet kezdeményez. Ha ezt a paramétert használja, a parancsmag egy TestConnectionCommand+TraceStatus objektumot ad vissza.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

TraceRoute

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

TestConnectionCommand+PingStatus

Ez a parancsmag alapértelmezés szerint egy TestConnectionCommand+PingStatus objektumot ad vissza minden pingválaszhoz.

TestConnectionCommand+TraceStatus

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

Boolean

Ha a Quiet vagy TcpPort paramétereket használja, ez a parancsmag egy logikai értéket ad vissza. Ha a parancsmag több kapcsolatot tesztel, logikai értékeket tartalmazó tömböt ad vissza.

TestConnectionCommand+PingMtuStatus

Az MtuSize paraméter használatakor ez a parancsmag egy TestConnectionCommand+PingMtuStatus objektumot ad vissza minden pingválaszhoz.

Kapcsolódó hivatkozások

• Számítógép újraindítása
• Számítógép leállítása