Test-Connection

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

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

Test-Connection
    [-ComputerName] <String[]>
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [-Quiet]
    [<CommonParameters>]

Den Test-Connection-cmdleten skickar ICMP-ekobegäran-paket (Internet Control Message Protocol), eller pingar, till en eller flera fjärrdatorer och returnerar ekosvar. 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 för Test-Connection 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 kommandot ping returnerar Test-Connection 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.

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.

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

Test-Connection -ComputerName Server01, Server02, Server12

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 pingbegäran från källdatorerna. Använd det här kommandoformatet för att testa svarstiden för anslutningar från flera punkter.

I det här exemplet används parametrarna för Test-Connection 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 med 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.

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 hämtar Receive-Job resultatet och lagrar dem i variabeln $Results.

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 Impersonation för att ändra personifieringsnivån till Identifiera.

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

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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

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

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

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.

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

Parameteruppsättningen Source introducerades i PowerShell 3.0.