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

Default (Výchozí)

Test-Connection
    [-ComputerName] <String[]>
    [-AsJob]
    [-Authentication <AuthenticationLevel>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Source

Test-Connection
    [-ComputerName] <String[]>
    [-Source] <String[]>
    [-AsJob]
    [-Authentication <AuthenticationLevel>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Credential <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Quiet

Test-Connection
    [-ComputerName] <String[]>
    [-Authentication <AuthenticationLevel>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [-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 příkaz pingTest-Connection vrátí objekt Win32_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 -ComputerName Server01

Source        Destination     IPV4Address     IPV6Address  Bytes    Time(ms)
------        -----------     -----------     -----------  -----    --------
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       1

Test-Connection k určení počítače Server01 používá parametr ComputerName.

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 -ComputerName Server01, Server02, Server12

Příklad 3: Odeslání žádostí o odezvu z několika počítačů do počítače

Tento příklad odesílá příkazy ping z různých zdrojových počítačů do jednoho vzdáleného počítače Server01.

Test-Connection -Source Server02, Server12, localhost -ComputerName Server01 -Credential Domain01\Admin01

Test-Connection používá parametr credential k zadání přihlašovacích údajů uživatele, který má oprávnění odeslat požadavek ping ze zdrojových počítačů. Tento formát příkazu slouží k otestování latence připojení z více bodů.

Příklad 4: 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 -ComputerName Server01 -Count 3 -Delay 2 -TTL 255 -BufferSize 256 -ThrottleLimit 32

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 5: Spuštění testu jako úlohy na pozadí

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

$job = Test-Connection -ComputerName (Get-Content Servers.txt) -AsJob
if ($job.JobStateInfo.State -ne "Running") {$Results = Receive-Job $job}

Příkaz Test-Connection příkaz ping odešle příkaz ping na mnoho počítačů v podniku. Hodnota parametru ComputerName je příkaz Get-Content, který čte seznam názvů počítačů z Servers.txt file. Příkaz používá parametr AsJob ke spuštění příkazu jako úlohu na pozadí a uloží úlohu do proměnné $job.

Příkaz if zkontroluje, jestli úloha stále není spuštěná. Pokud úloha není spuštěná, Receive-Job získá výsledky a uloží je do proměnné $Results.

Příklad 6: Příkaz ping na vzdálený počítač s přihlašovacími údaji

Tento příkaz používá rutinu Test-Connection ke vzdálenému počítači příkazem ping.

Test-Connection Server55 -Credential Domain55\User01 -Impersonation Identify

Příkaz používá parametr přihlašovacích údajů k určení uživatelského účtu, který má oprávnění ke vzdálenému počítači ping, a parametru Zosobnění změnit úroveň zosobnění na Identifikovat.

Příklad 7: Vytvoření relace pouze v případě úspěšného testu připojení

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 -ComputerName Server01 -Quiet) {New-PSSession Server01}

Příkaz if používá rutinu Test-Connection k příkazu ping na počítač se serverem 01. Příkaz používá parametr Quiet, který místo objektu Win32_PingStatus vrací logickou hodnotu. Hodnota je $True, pokud některý ze čtyř příkazů ping proběhne úspěšně a v opačném případě $False.

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

Parametry

-AsJob

Označuje, že tato rutina běží jako úloha na pozadí.

Chcete-li použít tento parametr, musí být místní a vzdálené počítače nakonfigurovány pro vzdálenou komunikace a v systému Windows Vista a novějších verzích operačního systému Windows je nutné otevřít PowerShell pomocí možnosti Spustit jako správce. Další informace naleznete v tématu about_Remote_Requirements.

Když zadáte parametr AsJob, příkaz okamžitě vrátí objekt, který představuje úlohu na pozadí. Během dokončení úlohy můžete pokračovat v práci v relaci. Úloha se vytvoří v místním počítači a výsledky ze vzdálených počítačů se automaticky vrátí do místního počítače. K získání výsledků úlohy použijte rutinu Receive-Job.

Další informace o úlohách na pozadí PowerShellu najdete v tématu about_Jobs a about_Remote_Jobs.

Vlastnosti parametru

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

Sady parametrů

Default

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

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

-Authentication

Určuje úroveň ověřování, která se používá pro připojení rozhraní WMI. Test-Connection používá rozhraní WMI.

Platné hodnoty jsou následující:

beze změny: Úroveň ověřování je stejná jako předchozí příkaz.
výchozí: Ověřování systému Windows.
Žádné: Žádné ověřování modelu COM.
Connect: Ověřování modelu COM na úrovni připojení.
volání: Ověřování modelu COM na úrovni volání.
paketů: Ověřování modelu COM na úrovni paketů.
packetIntegrity: Ověřování modelu COM na úrovni integrity paketů.
packetPrivacy: Ověřování modelu COM na úrovni ochrany osobních údajů paketů.

Výchozí hodnota je Packet, která má výčtovou hodnotu 4. Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationLevel výčtu.

Vlastnosti parametru

Typ:	AuthenticationLevel
Default value:	Packet (enumerated value of 4)
Přípustné hodnoty:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
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

-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ů

(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

-ComputerName

Určuje počítače, které mají příkaz ping. Zadejte názvy počítačů nebo zadejte IP adresy ve formátu IPv4 nebo IPv6. Zástupné znaky nejsou povoleny. Tento parametr je povinný.

Tento parametr nespoléhá na vzdálenou komunikaci PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Čína, IP adresa, __SERVER, počítačový server, Cíl

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
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ů

(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

-Credential

Určuje uživatelský účet, který má oprávnění odeslat požadavek ping ze zdrojového počítače. Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential, například objekt z rutiny Get-Credential.

Parametr credential je platný pouze v případě, že se v příkazu použije parametr Source. Přihlašovací údaje nemají vliv na cílový počítač.

Vlastnosti parametru

Typ:	PSCredential
Default value:	Current user
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Source

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:	1 (second)
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

-Impersonation

Určuje úroveň zosobnění, která se má použít, když tato rutina volá rozhraní WMI. Test-Connection používá rozhraní WMI.

Přijatelné hodnoty pro tento parametr jsou následující:

Výchozí. Výchozí zosobnění
Anonymní. Skryje identitu volajícího.
Identifikovat. Umožňuje objektům dotazovat přihlašovací údaje volajícího.
zosobnit. Umožňuje objektům používat přihlašovací údaje volajícího.

Výchozí hodnota je zosobnit.

Vlastnosti parametru

Typ:	ImpersonationLevel
Default value:	Impersonate
Přípustné hodnoty:	Default, Anonymous, Identify, Impersonate, Delegate
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

-Quiet

Parametr Quiet vrátí logickou hodnotu v objektu System.Boole an. Použití tohoto parametru potlačí všechny chyby.

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

Pokud jakýkoli příkaz ping proběhne úspěšně, vrátí se $True.

Pokud všechny příkazy ping selžou, vrátí se $False.

Vlastnosti parametru

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

Sady parametrů

Quiet

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č.

Vlastnosti parametru

Typ:	String[]
Default value:	Local computer
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	FCN, SRC

Sady parametrů

Source

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

-ThrottleLimit

Určuje maximální počet souběžných připojení, která lze navázat pro spuštění tohoto příkazu. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, použije se výchozí hodnota 32.

Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.

Vlastnosti parametru

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

Sady parametrů

Default

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

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

-TimeToLive

Určuje maximální dobu předání paketu. U každého segmentu směrování v branách, směrovačích atd. hodnota TimeToLive se sníží o jednu. Při nule se paket zahodí a vrátí se chyba. Ve Windowsje výchozí hodnota 128. Alias parametru TimeToLive je hodnota TTL.

Vlastnosti parametru

Typ:	Int32
Default value:	128 in Windows
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	hodnota TTL

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

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

Vstup do této rutiny nelze převést.

Výstupy

ManagementObject

Tato rutina vrátí objekt úlohy, pokud zadáte parametr AsJob.

Pokud zadáte parametr Quiet, vrátí logickou hodnotu. Pokud se testuje více připojení, vrátí se pole Booleanových hodnot. V opačném případě Test-Connection vrátí objekt Win32_PingStatus pro každý příkaz ping.

Poznámky

Tato rutina používá třídu Win32_PingStatus. Příkaz Get-WMIObject Win32_PingStatus je ekvivalentní příkazu Test-Connection.

Sada parametrů Source byla zavedena v PowerShellu 3.0.

Sdílet prostřednictvím

Test-Connection

Syntax

Default (Výchozí)

Source

Quiet

Description

Příklady

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

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

Příklad 3: Odeslání žádostí o odezvu z několika počítačů do počítače

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

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

Příklad 6: Příkaz ping na vzdálený počítač s přihlašovacími údaji

Příklad 7: Vytvoření relace pouze v případě úspěšného testu připojení

Parametry

-AsJob

Vlastnosti parametru

Sady parametrů

-Authentication

Vlastnosti parametru

Sady parametrů

-BufferSize

Vlastnosti parametru

Sady parametrů

-ComputerName

Vlastnosti parametru

Sady parametrů

-Count

Vlastnosti parametru

Sady parametrů

-Credential

Vlastnosti parametru

Sady parametrů

-Delay

Vlastnosti parametru

Sady parametrů

-Impersonation

Vlastnosti parametru

Sady parametrů

-Quiet

Vlastnosti parametru

Sady parametrů

-Source

Vlastnosti parametru

Sady parametrů

-ThrottleLimit

Vlastnosti parametru

Sady parametrů

-TimeToLive

Vlastnosti parametru

Sady parametrů

CommonParameters

Vstupy

None

Výstupy

ManagementObject

Poznámky

Související odkazy