Test-Connection

Referencia

Modul:: Microsoft.PowerShell.Management

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 elküldi az Internet Control Message Protocol (ICMP) visszhangkérelem-csomagjait vagy pingeit egy vagy több távoli számítógépnek, és visszaadja a visszhangra adott 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 Test-Connection 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 pingelési paranccsal Test-Connection ellentétben egy Test Csatlakozás ionCommand+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. 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-ConnectionA TargetName paraméterrel adja meg a Server01 számítógépet. Az IPv4 paraméter határozza meg a teszt protokollát.

A rendszer egy sor Test Csatlakozás ionCommand+PingStatus objektumot küld a kimeneti streambe, egy objektumot pingelésre válaszként a célgéprő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 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épre.

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

Test-ConnectionA TargetName paraméterrel adja meg a Server01 értéket. A Count paraméter három pingelést határoz meg, amelyek 2 másodperces késleltetéssel érkeznek a Server01 számítógépre.

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 Test-Connection parancsokat 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 olyan 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óban.

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 sikerül, az érték .$False

Ha a Test-Connection parancs egy értéket $Truead vissza, a parancs a New-PSSession parancsmaggal hozza létre a PSSessiont.

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 TargetName paraméterrel megadott távoli cél között.

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 Success kimeneti adatfolyam kimenete.

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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Count

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

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

-Delay

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

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

-DontFragment

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

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

Type:	Int32
Aliases:	Ttl, TimeToLive, Hops
Position:	Named
Default value:	128
Required:	False
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 tartalmazza a cél elérési út MTU-méretét. A Path MTU-ról további információt a Path MTU Discovery című cikkben talál a Wikipédiában.

Type:	SwitchParameter
Aliases:	MtuSizeDetect
Position:	Named
Default value:	False
Required:	True
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
Required:	False
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 tiltva.

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élhoz tartozó összes pingelés sikertelen, $False a rendszer visszaadja.

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

-Repeat

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

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

-ResolveDestination

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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. Alapértelmezés szerint a helyi számítógép.

Feljegyzés

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

Type:	String
Position:	Named
Default value:	Local computer
Required:	False
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
Required:	True
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étrejön egy kapcsolat, $True a rendszer visszaadja.

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

Type:	Int32
Position:	Named
Default value:	None
Required:	True
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 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.

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

-Traceroute

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

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

TestConnectionCommand+PingStatus

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

TestConnectionCommand+TraceStatus

A Traceroute paraméter használatakor ez a parancsmag egy Test Csatlakozás ionCommand+TraceStatus objektumot ad vissza az útvonal minden egyes pingválaszához.

Boolean

A Quiet vagy TcpPort paraméterek használatakor ez a parancsmag 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 Test Csatlakozás ionCommand+PingMtuStatus objektumot ad vissza minden pingválaszhoz.

Test-Connection

Syntax

Description

Példák

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

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

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

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

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

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

Paraméterek

-BufferSize

-Count

-Delay

-DontFragment

-IPv4

-IPv6

-MaxHops

-MtuSize

-Ping

-Quiet

-Repeat

-ResolveDestination

-Source

-TargetName

-TcpPort

-TimeoutSeconds

-Traceroute

Bevitelek

Kimenetek

Visszajelzés

További források

Test-Connection

Syntax

Description

Példák

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

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

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

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

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

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

Paraméterek

-BufferSize

-Count

-Delay

-DontFragment

-IPv4

-IPv6

-MaxHops

-MtuSize

-Ping

-Quiet

-Repeat

-ResolveDestination

-Source

-TargetName

-TcpPort

-TimeoutSeconds

-Traceroute

Bevitelek

Kimenetek

Kapcsolódó hivatkozások

Visszajelzés

További források