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

Default (Alapértelmezett)

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

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 pingelési paranccsal ellentétben Test-Connection egy Win32_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 -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 a ComputerName paraméterrel adja meg a Server01 számítógépet.

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

3. példa: Echo-kérések küldése több számítógépről egy számítógépre

Ez a példa pingeket küld a különböző forrásszámítógépekről egyetlen távoli számítógépre, a Server01-be.

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

Test-Connection a Hitelesítő adatok paraméterrel adja meg egy olyan felhasználó hitelesítő adatait, aki jogosult pingelési kérést küldeni a forrásszámítógépről. Ezzel a parancsformátummal tesztelje a több pontból érkező kapcsolatok késését.

4. 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 -ComputerName Server01 -Count 3 -Delay 2 -TTL 255 -BufferSize 256 -ThrottleLimit 32

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.

5. 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 = Test-Connection -ComputerName (Get-Content Servers.txt) -AsJob
if ($job.JobStateInfo.State -ne "Running") {$Results = Receive-Job $job}

A Test-Connection parancs egy vállalat számos számítógépét pingeli. A ComputerName paraméter értéke egy Get-Content parancs, amely beolvassa a számítógépnevek listáját a Servers.txt file. A parancs a AsJob paraméterrel futtatja a parancsot háttérfeladatként, és menti a feladatot a $job változóban.

A if parancs ellenőrzi, hogy a feladat még nem fut-e. Ha a feladat nem fut, Receive-Job lekéri az eredményeket, és a $Results változóban tárolja őket.

6. példa: Távoli számítógép pingelése hitelesítő adatokkal

Ez a parancs a Test-Connection parancsmaggal pingel egy távoli számítógépet.

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

A parancs a Hitelesítő adatok paraméterrel adja meg a távoli számítógép és a megszemélyesítési paraméter pingelésére jogosult felhasználói fiókot, hogy a megszemélyesítési szintet Azonosítsa.

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

A if parancs a Test-Connection parancsmaggal pingeli a Server01 számítógépet. A parancs a Quiet paramétert használja, amely egy Win32_PingStatus objektum helyett egy logikai értéket ad vissza. Az érték $True, ha a négy ping bármelyike sikeres, és egyébként $False.

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

Paraméterek

-AsJob

Azt jelzi, hogy ez a parancsmag háttérfeladatként fut.

A paraméter használatához a helyi és a távoli számítógépeket újra kell konfigurálni, és Windows Vista és a Windows operációs rendszer újabb verzióiban a PowerShellt a Rendszergazdai beállítással kell megnyitnia. További információkért lásd: about_Remote_Requirements.

Amikor megadja a AsJob paramétert, a parancs azonnal visszaad egy objektumot, amely a háttérfeladatot jelöli. Folytathatja a munkát a munkamenetben, amíg a feladat befejeződik. A feladat a helyi számítógépen jön létre, és a távoli számítógépek eredményei automatikusan visszakerülnek a helyi számítógépre. A feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.

További információ a PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.

Paramétertulajdonságok

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

Paraméterkészletek

Default

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

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

-Authentication

Megadja a WMI-kapcsolathoz használt hitelesítési szintet. Test-Connection WMI-t használ.

Az érvényes értékek a következők:

Változatlan: A hitelesítési szint megegyezik az előző paranccsal.
Alapértelmezett: Windows-hitelesítés.
Nincs: Nincs COM-hitelesítés.
Csatlakozás: Kapcsolódási szintű COM-hitelesítés.
Hívási: Hívásszintű COM-hitelesítés.
Csomag: Csomagszintű COM-hitelesítés.
PacketIntegrity: Csomagintegritási szintű COM-hitelesítés.
PacketPrivacy: Packet Privacy szintű COM-hitelesítés.

Az alapértelmezett érték csomag, amelynek számbavétele 4. A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationLevel enumerálást.

Paramétertulajdonságok

Típus:	AuthenticationLevel
Alapértelmezett érték:	Packet (enumerated value of 4)
Elfogadott értékek:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
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

-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

(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

-ComputerName

Megadja a pingelni kívánt számítógépeket. Írja be a számítógépneveket, vagy írja be az IP-címeket IPv4 vagy IPv6 formátumban. A helyettesítő karakterek nem engedélyezettek. Ez a paraméter kötelező.

Ez a paraméter nem támaszkodik a PowerShell távoli elérésre. A ComputerName paramétert akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Kína, IP cím, __KISZOLGÁLÓ, Szerver, Úti cél

Paraméterkészletek

(All)

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

(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

-Credential

Olyan felhasználói fiókot ad meg, amely rendelkezik ping-kérés küldéséhez a forrásszámítógépről. Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, például egyet a Get-Credential parancsmagból.

A Hitelesítő adatok paraméter csak akkor érvényes, ha a parancsban a Forrás paramétert használja. A hitelesítő adatok nincsenek hatással a célszámítógépre.

Paramétertulajdonságok

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

Paraméterkészletek

Source

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

-Impersonation

Megadja azt a megszemélyesítési szintet, amelyet akkor kell használni, amikor ez a parancsmag meghívja a WMI-t. Test-Connection WMI-t használ.

A paraméter elfogadható értékei a következők:

Alapértelmezett Alapértelmezett megszemélyesítés.
Névtelen. Elrejti a hívó identitását.
azonosítása. Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
Megszemélyesítse. Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.

Az alapértelmezett érték Megszemélyesítés.

Paramétertulajdonságok

Típus:	ImpersonationLevel
Alapértelmezett érték:	Impersonate
Elfogadott értékek:	Default, Anonymous, Identify, Impersonate, Delegate
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

-Quiet

A Quiet paraméter egy Logikai értéket ad vissza egy System.Boolean objektumban. Ezzel a paraméterrel minden hiba el lesz tiltva.

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

Ha bármely ping sikeres, $True lesz visszaadva.

Ha minden pingelés sikertelen, $False lesz visszaadva.

Paramétertulajdonságok

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

Paraméterkészletek

Quiet

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.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	Local computer
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	FCN, SRC

Paraméterkészletek

Source

Position:	1
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

-ThrottleLimit

Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát. Ha kihagyja ezt a paramétert, vagy 0 értéket ad meg, a rendszer az alapértelmezett 32 értéket használja.

A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.

Paramétertulajdonságok

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

Paraméterkészletek

Default

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

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

-TimeToLive

Meghatározza, hogy egy csomag legfeljebb hányszor továbbítható. Az átjárók, útválasztók stb. minden ugrása esetén a TimeToLive értéke eggyel csökken. A rendszer nullára elveti a csomagot, és hibát ad vissza. A Windowsalapértelmezett értéke 128. A TimeToLive paraméter aliasa TTL.

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	128 in Windows
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	élettartam

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

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 bemenő adatokat becsúszni.

Kimenetek

ManagementObject

Ez a parancsmag egy feladatobjektumot ad vissza, ha megadja az AsJob paramétert.

Ha megadja a Quiet paramétert, az egy logikai értéket ad vissza. Több kapcsolat tesztelése esetén a rendszer logikai értékeket tartalmazó tömböt ad vissza. Ellenkező esetben Test-Connection minden pinghez egy Win32_PingStatus objektumot ad vissza.

Jegyzetek

Ez a parancsmag a Win32_PingStatus osztályt használja. A Get-WMIObject Win32_PingStatus parancs egyenértékű egy Test-Connection paranccsal.

A Source paraméterkészlet a PowerShell 3.0-ban lett bevezetve.

Megosztás a következőn keresztül:

Test-Connection

Syntax

Default (Alapértelmezett)

Source

Quiet

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: Echo-kérések küldése több számítógépről egy számítógépre

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

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

6. példa: Távoli számítógép pingelése hitelesítő adatokkal

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

Paraméterek

-AsJob

Paramétertulajdonságok

Paraméterkészletek

-Authentication

Paramétertulajdonságok

Paraméterkészletek

-BufferSize

Paramétertulajdonságok

Paraméterkészletek

-ComputerName

Paramétertulajdonságok

Paraméterkészletek

-Count

Paramétertulajdonságok

Paraméterkészletek

-Credential

Paramétertulajdonságok

Paraméterkészletek

-Delay

Paramétertulajdonságok

Paraméterkészletek

-Impersonation

Paramétertulajdonságok

Paraméterkészletek

-Quiet

Paramétertulajdonságok

Paraméterkészletek

-Source

Paramétertulajdonságok

Paraméterkészletek

-ThrottleLimit

Paramétertulajdonságok

Paraméterkészletek

-TimeToLive

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Bevitelek

None

Kimenetek

ManagementObject

Jegyzetek

Kapcsolódó hivatkozások