Test-Connection

Modul:

Microsoft.PowerShell.Management Module

Odešle pakety s žádostí o odezvu protokolu ICMP, nebo pingy, do jednoho nebo více počítačů.

Syntax

DefaultPing (Výchozí)

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

Rutina Test-Connection odesílá požadavky na odezvu protokolu ICMP (Internet Control Message Protocol), nebo pinguje, do jednoho nebo více vzdálených počítačů a vrací odpovědi. Pomocí této rutiny můžete určit, jestli se konkrétní počítač dá kontaktovat přes síť IP.

Pomocí parametrů Test-Connection můžete určit odesílající i přijímající počítače, spustit příkaz jako úlohu na pozadí, nastavit časový limit a počet příkazů ping a nakonfigurovat připojení a ověřování.

Na rozdíl od známého příkazu ping vrátí Test-Connection objekt TestConnectionCommand+PingStatus, který můžete prozkoumat v PowerShellu. Parametr Quiet vrátí logickou hodnotu v objektu System.Boolean pro každé testované připojení. Pokud se testuje více připojení, vrátí se pole Booleanových hodnot.

Příklady

Příklad 1: Odeslání žádostí o odezvu vzdálenému počítači

Tento příklad odešle pakety požadavků na odezvu z místního počítače do počítače 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 používá parametr TargetName k určení počítače Server01. Parametr IPv4 určuje protokol pro test.

Do výstupního datového proudu se odesílá série objektů TestConnectionCommand+PingStatus, jeden objekt pro každou odpověď ping z cílového počítače.

Příklad 2: Odeslání žádostí o odezvu na několik počítačů

Tento příklad odešle příkazy ping z místního počítače do několika vzdálených počítačů.

Test-Connection -TargetName Server01, Server02, Server12

Příklad 3: Použití parametrů k přizpůsobení testovacího příkazu

Tento příklad používá parametry Test-Connection k přizpůsobení příkazu. Místní počítač odešle test ping do vzdáleného počítače.

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

Test-Connection k určení serveru Server01 používá parametr TargetName. Parametr Count určuje, že do počítače Server01 jsou posílány tři pingy s intervalem dvou sekund.

Tyto možnosti můžete použít, pokud se očekává, že odpověď ping bude trvat déle než obvykle, a to buď kvůli většímu počtu hopů, nebo kvůli vysokému zatížení sítě.

Příklad 4: Spuštění testu jako úlohy na pozadí

Tento příklad ukazuje, jak spustit příkaz Test-Connection jako úlohu na pozadí PowerShellu.

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

Příkaz Start-Job používá cmdlet Test-Connection k pingování mnoha počítačů v podniku. Hodnota parametru TargetName je příkaz Get-Content, který čte seznam názvů počítačů ze souboru Servers.txt. Příkaz používá rutinu Start-Job ke spuštění příkazu jako úlohu na pozadí a uloží úlohu do proměnné $job.

Příkaz Receive-Job je instruován k -Wait, dokud se úloha nedokončí, a poté získá výsledky a uloží je do proměnné $Results.

Příklad 5: Vytvořte relaci pouze pokud test připojení uspěje

Tento příklad vytvoří relaci na počítači Server01 pouze v případě, že alespoň jeden z příkazů ping odeslaných do počítače bude úspěšný.

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

Rutina Test-Connection odešle příkaz ping na počítač Server01 s zadaným parametrem Quiet. Výsledná hodnota je $True, pokud některý ze čtyř příkazů ping proběhne úspěšně. Pokud žádný z pingů nebude úspěšný, hodnota je $False.

Pokud příkaz Test-Connection vrátí hodnotu $True, příkaz použije rutinu New-PSSession k vytvoření psSession.

Příklad 6: Použití parametru Traceroute

V PowerShellu 6.0 se parametr Traceroute mapuje trasu mezi místním počítačem a vzdáleným cílem, který zadáte pomocí parametru 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

Příkaz Test-Connection se volá pomocí parametru Traceroute. Výsledky, které jsou [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus] objekty, jsou vyvedeny do výstupního streamu Success.

Parametry

-BufferSize

Určuje velikost vyrovnávací paměti odeslané tímto příkazem v bajtech. Výchozí hodnota je 32.

Vlastnosti parametru

Typ:	Int32
Default value:	32
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Velikost, Bytes, bakalář přírodních věd

Sady parametrů

DefaultPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

RepeatPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Count

Určuje počet požadavků na odezvu, které se mají odeslat. Výchozí hodnota je 4.

Vlastnosti parametru

Typ:	Int32
Default value:	4
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DefaultPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Delay

Určuje interval mezi příkazy ping v sekundách.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DefaultPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

RepeatPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DontFragment

Tento parametr nastaví příznak Don't Fragment v hlavičce IP protokolu. Tento parametr můžete použít s parametrem BufferSize k otestování velikosti MTU cesty. Další informace o Path MTU naleznete v článku Path MTU Discovery wikipedia.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DefaultPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

RepeatPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IPv4

Přinutí cmdlet, aby pro test používal protokol IPv4.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IPv6

Vynutí cmdlet, aby pro test používal protokol IPv6.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaxHops

Nastaví maximální počet směrovacích skoků, které lze odeslat v rámci zprávy protokolu ICMP. Výchozí hodnota je řízena operačním systémem. Výchozí hodnota pro Windows 10 a vyšší je 128 skoků.

Vlastnosti parametru

Typ:	Int32
Default value:	128
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Hodnota ttl, TimeToLive, Chmel

Sady parametrů

DefaultPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

RepeatPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

TraceRoute

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MtuSize

Tento parametr se používá ke zjištění velikosti PATH MTU. Cmdlet vrátí objekt PingReply#MTUSize, který obsahuje velikost MTU pro cestu k cíli. Další informace o Path MTU naleznete v článku Path MTU Discovery wikipedia.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	MtuSizeDetect

Sady parametrů

MtuSizeDetect

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Ping

Způsobí, že cmdlet provede test ping. Toto je výchozí režim pro rutinu Test-Connection.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	True
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DefaultPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

RepeatPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Quiet

Parametr Quiet vrátí Booleovskou hodnotu. Použití tohoto parametru potlačí všechny chyby.

Každé otestované připojení vrátí logickou hodnotu. Pokud parametr TargetName určuje více počítačů, vrátí se pole logických hodnot.

Pokud jakýkoli ping na daný cíl uspěje, vrátí se $True.

Pokud všechny provedené pingy na daný cíl selžou, je vráceno $False.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Repeat

Způsobí, že rutina bude odesílat žádosti ping nepřetržitě. Pokud je hodnota TargetName pole cílů, rutina opakuje požadavky ping pouze pro první cíl. Ignoruje zbývající cíle. Tento parametr nelze použít s parametrem Count.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Nepřetržité

Sady parametrů

RepeatPing

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ResolveDestination

Způsobí, že se cmdlet pokouší vyřešit název DNS cíle. Pokud se použije společně s parametrem Traceroute, budou také, pokud to bude možné, načteny názvy DNS všech zprostředkujících hostitelů.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Source

Určuje názvy počítačů, ze kterých pochází příkaz ping. Zadejte čárkami oddělený seznam názvů počítačů. Výchozí hodnota je místní počítač.

Poznámka:

Tento parametr není podporován ve verzích PowerShellu 6 a novějších. Zadání tohoto parametru způsobí chybu.

Vlastnosti parametru

Typ:	String
Default value:	Local computer
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DefaultPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

RepeatPing

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

TraceRoute

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

TcpPort

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-TargetName

Určuje počítače, které se mají testovat. Zadejte názvy počítačů nebo zadejte IP adresy ve formátu IPv4 nebo IPv6.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Název počítače

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-TcpPort

Určuje číslo portu TCP v cíli, které se má použít v testu připojení TCP. Rutina se pokusí vytvořit připojení TCP k zadanému portu v cíli.

Pokud lze navázat spojení, $True bude vráceno.

Pokud připojení nelze navázat, bude vráceno. $False

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

TcpPort

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-TimeoutSeconds

Nastaví hodnotu časového limitu testu. Test selže, pokud odpověď není přijata před vypršením časového limitu. Výchozí hodnota je pět sekund.

Tento parametr byl představen v PowerShellu 6.0.

Vlastnosti parametru

Typ:	Int32
Default value:	5 seconds
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Traceroute

Způsobí, že rutina provede test traceroute. Při použití tohoto parametru vrátí rutina objekt TestConnectionCommand+TraceStatus.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

TraceRoute

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

TestConnectionCommand+PingStatus

Ve výchozím nastavení tato rutina vrátí TestConnectionCommand+PingStatus objekt pro každou odpověď ping.

TestConnectionCommand+TraceStatus

Pokud použijete parametr Traceroute, tento příkaz vrátí objekt TestConnectionCommand+TraceStatus pro každou odpověď ping na trase.

Boolean

Pokud použijete parametry Quiet nebo TcpPort, vrátí tato rutina logickou hodnotu. Pokud rutina testuje více připojení, vrátí pole Boolean hodnot.

TestConnectionCommand+PingMtuStatus

Pokud použijete parametr MtuSize, vrátí tato rutina TestConnectionCommand+PingMtuStatus objekt pro každou odpověď ping.

Související odkazy

• Restartovat počítač
• Zastavit počítač