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
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-ComputerName] <String[]>
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

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

Test-Connection
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-ComputerName] <String[]>
    [-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 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 Win32_PingStatus objektumot ad vissza, amelyet megvizsgálhat a PowerShellben. 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 -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-ConnectionA 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 annak a felhasználónak a 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 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 -ComputerName Server01 -Count 3 -Delay 2 -TTL 255 -BufferSize 256 -ThrottleLimit 32

Test-ConnectionA ComputerName 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.

5. 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 = 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 az 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, lekéri az eredményeket, Receive-Job és tárolja őket a $Results változóban.

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 egy olyan felhasználói fiókot ad meg, amely rendelkezik engedéllyel a távoli számítógép pingeléséhez, és a Megszemélyesítés paraméterrel a megszemélyesítési szintet az Azonosítás értékre módosítja.

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 logikai értéket ad vissza Win32_PingStatus objektum helyett. Az érték az, $True ha a négy ping bármelyike sikeres, és ellenkező esetben $False.

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

Paraméterek

-AsJob

Azt jelzi, hogy ez a parancsmag háttérfeladatként fut. Az AsJob paraméter megadásakor 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 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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-BufferSize

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

Típus:	Int32
Aliasok:	Size, Bytes, BS
Position:	Named
Alapértelmezett érték:	32
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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-újraegyezésre. Akkor is használhatja a ComputerName paramétert, ha a számítógép nincs távoli parancsok futtatására konfigurálva.

Feljegyzés

A ComputerName paraméter a PowerShell 6.0-s vagy újabb verziója TargetName-ra van átnevezve.

Típus:	String[]
Aliasok:	CN, IPAddress, __SERVER, Server, Destination
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Count

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

Típus:	Int32
Position:	Named
Alapértelmezett érték:	4
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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őadat-paraméter csak akkor érvényes, ha a Forrás paramétert használja a parancs. A hitelesítő adatok nincsenek hatással a célszámítógépre.

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	Current user
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DcomAuthentication

Megadja a parancsmag által a WMI-vel használt hitelesítési szintet. Test-Connection WMI-t használ. A paraméter elfogadható értékei a következők:

Alapértelmezett érték. Windows-hitelesítés
Nincs. Nincs COM-hitelesítés
Csatlakozás. Kapcsolódási szintű COM-hitelesítés
Hívás. Hívásszintű COM-hitelesítés
Csomag. Csomagszintű COM-hitelesítés
PacketIntegrity. Csomagintegritási szintű COM-hitelesítés
PacketPrivacy. Csomag adatvédelmi szintű COM-hitelesítése
Változatlan. Ugyanaz, mint az előző parancs

Az alapértelmezett érték a Csomag , amelynek enumerált értéke 4. A paraméter értékeivel kapcsolatos további információkért lásd : AuthenticationLevel enumerálás.

Típus:	AuthenticationLevel
Aliasok:	Authentication
Elfogadott értékek:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:	Named
Alapértelmezett érték:	Packet (enumerated value of 4)
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Delay

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

Típus:	Int32
Position:	Named
Alapértelmezett érték:	1 (second)
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 érték. Alapértelmezett megszemélyesítés.
Névtelen. Elrejti a hívó identitását.
Azonosítsa. Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
Megszemélyesítés. Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.

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

Típus:	ImpersonationLevel
Elfogadott értékek:	Default, Anonymous, Identify, Impersonate, Delegate
Position:	Named
Alapértelmezett érték:	Impersonate
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Protocol

Protokollt ad meg. A paraméter elfogadható értékei a DCOM és a WSMan.

Típus:	String
Elfogadott értékek:	DCOM, WSMan
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 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ármelyik ping sikeres, $True a függvény visszaadja.

Ha az összes pingelés sikertelen, $False a függvény visszaadja.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	String[]
Aliasok:	FCN, SRC
Position:	1
Alapértelmezett érték:	Local computer
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Int32
Position:	Named
Alapértelmezett érték:	32
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 egyel csökken. A rendszer nullára elveti a csomagot, és hibát ad vissza. Windows rendszerben az alapértelmezett érték 128. A TimeToLive paraméter aliasa A TTL.

Típus:	Int32
Aliasok:	TTL
Position:	Named
Alapértelmezett érték:	128 in Windows
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WsmanAuthentication

Megadja azt a mechanizmust, amely a felhasználói hitelesítő adatok hitelesítésére szolgál, amikor ez a parancsmag a WSMan protokollt használja. A paraméter elfogadható értékei a következők:

Alap
CredSSP
Alapértelmezett
Emészt
Kerberos
Tárgyal.

Az alapértelmezett érték az Alapértelmezett érték.

A paraméter értékeivel kapcsolatos további információkért lásd : AuthenticationMechanism Enumeration.

Figyelem: A hitelesítő adatok biztonsági szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.

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

Típus:	String
Elfogadott értékek:	Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:	Named
Alapértelmezett érték:	Default
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

ManagementObject

Ez a parancsmag alapértelmezés szerint egy Win32_PingStatus objektumot ad vissza az egyes pingelési válaszokhoz.

System.Management.Automation.RemotingJob

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

Boolean

A Quiet paraméter használatakor ez logikai értéket ad vissza. Ha a parancsmag több kapcsolatot tesztel, logikai értékeket tartalmazó tömböt ad vissza.

Jegyzetek

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

A Forrás paraméterkészlet a PowerShell 3.0-ban lett bevezetve.

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

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

-BufferSize

-ComputerName

-Count

-Credential

-DcomAuthentication

-Delay

-Impersonation

-Protocol

-Quiet

-Source

-ThrottleLimit

-TimeToLive

-WsmanAuthentication

Bevitelek

Kimenetek

Jegyzetek

További források

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

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

-BufferSize

-ComputerName

-Count

-Credential

-DcomAuthentication

-Delay

-Impersonation

-Protocol

-Quiet

-Source

-ThrottleLimit

-TimeToLive

-WsmanAuthentication

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

További források