Test-Connection

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

Cmdleten Test-Connection skickar ICMP-paket (Internet Control Message Protocol) ekobegärandepaket, eller pingar, till en eller flera fjärrdatorer och returnerar ekosvarssvaren. Du kan använda den här cmdleten för att avgöra om en viss dator kan kontaktas i ett IP-nätverk.

Du kan använda parametrarna Test-Connection för för att ange både de sändande och mottagande datorerna, för att köra kommandot som ett bakgrundsjobb, för att ange tidsgräns och antal pingar samt för att konfigurera anslutningen och autentiseringen.

Till skillnad från det välbekanta pingkommandot Test-Connection returnerar ett Win32_PingStatus objekt som du kan undersöka i PowerShell. Parametern Quiet returnerar ett booleskt värde i ett System.Booleskt objekt för varje testad anslutning. Om flera anslutningar testas returneras en matris med booleska värden.

Exempel

Exempel 1: Skicka ekobegäranden till en fjärrdator

Det här exemplet skickar ekobegärandepaket från den lokala datorn till Server01-datorn.

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 använder parametern ComputerName för att ange Server01-datorn.

Exempel 2: Skicka ekobegäranden till flera datorer

Det här exemplet skickar ping från den lokala datorn till flera fjärrdatorer.

Test-Connection -ComputerName Server01, Server02, Server12

Exempel 3: Skicka ekobegäranden från flera datorer till en dator

Det här exemplet skickar ping från olika källdatorer till en enda fjärrdator, Server01.

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

Test-Connection använder parametern Credential för att ange autentiseringsuppgifterna för en användare som har behörighet att skicka en ping-begäran från källdatorerna. Använd det här kommandoformatet för att testa svarstiden för anslutningar från flera punkter.

Exempel 4: Använd parametrar för att anpassa testkommandot

I det här exemplet används parametrarna Test-Connection för för att anpassa kommandot. Den lokala datorn skickar ett pingtest till en fjärrdator.

Test-Connection -ComputerName Server01 -Count 3 -Delay 2 -TTL 255 -BufferSize 256 -ThrottleLimit 32

Test-Connection använder parametern ComputerName för att ange Server01. Parametern Count anger att tre pingar skickas till Server01-datorn med en fördröjning på 2 sekunders intervall.

Du kan använda de här alternativen när ping-svaret förväntas ta längre tid än vanligt, antingen på grund av ett utökat antal hopp eller ett nätverkstillstånd med hög trafik.

Exempel 5: Kör ett test som ett bakgrundsjobb

Det här exemplet visar hur du kör ett Test-Connection kommando som ett PowerShell-bakgrundsjobb.

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

Kommandot Test-Connection pingar många datorer i ett företag. Värdet för parametern ComputerName är ett Get-Content kommando som läser en lista med datornamn från Servers.txt file. Kommandot använder parametern AsJob för att köra kommandot som ett bakgrundsjobb och sparar jobbet i variabeln $job .

Kommandot if kontrollerar att jobbet inte fortfarande körs. Om jobbet inte körs Receive-Job hämtar du resultatet och lagrar dem i variabeln $Results .

Exempel 6: Pinga en fjärrdator med autentiseringsuppgifter

Det här kommandot använder cmdleten Test-Connection för att pinga en fjärrdator.

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

Kommandot använder parametern Credential för att ange ett användarkonto som har behörighet att pinga fjärrdatorn och parametern Personifiering för att ändra personifieringsnivån till Identifiera.

Exempel 7: Skapa endast en session om ett anslutningstest lyckas

Det här exemplet skapar en session på Server01-datorn endast om minst en av pingarna som skickas till datorn lyckas.

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

Kommandot if använder cmdleten Test-Connection för att pinga Server01-datorn. Kommandot använder parametern Tyst , som returnerar ett booleskt värde i stället för ett Win32_PingStatus objekt. Värdet är $True om någon av de fyra pingarna lyckas och annars $Falseär .

Test-Connection Om kommandot returnerar värdet $Trueanvänder kommandot cmdleten New-PSSession för att skapa PSSession.

Parametrar

-AsJob

-BufferSize

-ComputerName

-Count

-Credential

-DcomAuthentication

-Delay

-Impersonation

-Protocol

-Quiet

-Source

-ThrottleLimit

-TimeToLive

-WsmanAuthentication

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

ManagementObject

Som standard returnerar den här cmdleten ett Win32_PingStatus objekt för varje ping-svar.

System.Management.Automation.RemotingJob

Den här cmdleten returnerar ett jobbobjekt om du anger parametern AsJob .

Boolean

När du använder parametern Tyst returnerar detta ett booleskt värde. Om cmdleten testar flera anslutningar returneras en matris med booleska värden.

Kommentarer

Den här cmdleten använder klassen Win32_PingStatus . Ett Get-WMIObject Win32_PingStatus kommando motsvarar ett Test-Connection kommando.

Parameteruppsättningen Källa introducerades i PowerShell 3.0.

Relaterade länkar

• Add-Computer
• Restart-Computer
• Stop-Computer