Test-Connection

Sintassi

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

Descrizione

Il Test-Connection cmdlet invia pacchetti di richieste echo ICMP (Internet Control Message Protocol) o ping a uno o più computer remoti e restituisce le risposte di risposta echo. È possibile usare questo cmdlet per determinare se un determinato computer può essere contattato in una rete IP.

È possibile usare i parametri di Test-Connection per specificare sia i computer di invio che di ricezione, per eseguire il comando come processo in background, per impostare un timeout e il numero di ping e per configurare la connessione e l'autenticazione.

A differenza del comando ping familiare, restituisce un oggetto Win32_PingStatus che è possibile analizzare in PowerShell. Test-Connection Il parametro Quiet restituisce un valore booleano in un oggetto System.Boolean per ogni connessione testata. Se vengono testate più connessioni, viene restituita una matrice di valori booleani .

Esempio

Esempio 1: Inviare richieste echo a un computer remoto

In questo esempio vengono inviati pacchetti di richiesta echo dal computer locale al computer 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 utilizza il parametro ComputerName per specificare il computer Server01.

Esempio 2: Inviare richieste echo a diversi computer

In questo esempio vengono inviati ping dal computer locale a diversi computer remoti.

Test-Connection -ComputerName Server01, Server02, Server12

Esempio 3: Inviare richieste echo da diversi computer a un computer

In questo esempio vengono inviati ping da computer di origine diversi a un singolo computer remoto, Server01.

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

Test-Connection usa il parametro Credential per specificare le credenziali di un utente che dispone dell'autorizzazione per inviare una richiesta ping dai computer di origine. Usare questo formato di comando per testare la latenza delle connessioni da più punti.

Esempio 4: Usare i parametri per personalizzare il comando di test

In questo esempio vengono usati i parametri di Test-Connection per personalizzare il comando. Il computer locale invia un test ping a un computer remoto.

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

Test-Connection utilizza il parametro ComputerName per specificare Server01. Il parametro Count specifica che tre ping vengono inviati al computer Server01 con intervallo di ritardo di 2 secondi.

È possibile usare queste opzioni quando si prevede che la risposta ping richiede più tempo del solito, a causa di un numero esteso di hop o di una condizione di rete a traffico elevato.

Esempio 5: Eseguire un test come processo in background

Questo esempio illustra come eseguire un Test-Connection comando come processo in background di PowerShell.

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

Il comando esegue il Test-Connection ping di molti computer in un'organizzazione. Il valore del parametro ComputerName è un Get-Content comando che legge un elenco di nomi di computer da Servers.txt file. Il comando usa il parametro AsJob per eseguire il comando come processo in background e salva il processo nella $job variabile.

Il if comando verifica che il processo non sia ancora in esecuzione. Se il processo non è in esecuzione, Receive-Job ottiene i risultati e li archivia nella $Results variabile.

Esempio 6: Eseguire il ping di un computer remoto con credenziali

Questo comando usa il cmdlet per eseguire il Test-Connection ping di un computer remoto.

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

Il comando usa il parametro Credential per specificare un account utente che dispone dell'autorizzazione per effettuare il ping del computer remoto e il parametro Impersonation per modificare il livello di rappresentazione in Identificare.

Esempio 7: Creare una sessione solo se un test di connessione ha esito positivo

In questo esempio viene creata una sessione nel computer Server01 solo se almeno uno dei ping inviati al computer ha esito positivo.

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

Il if comando usa il Test-Connection cmdlet per eseguire il ping del computer Server01. Il comando usa il parametro Quiet , che restituisce un valore booleano , anziché un oggetto Win32_PingStatus . Il valore è $True se uno dei quattro ping ha esito positivo ed è, in caso contrario, $False.

Se il Test-Connection comando restituisce un valore , $Trueil comando usa il New-PSSession cmdlet per creare la sessione PSSession.

Parametri

-AsJob

-BufferSize

-ComputerName

-Count

-Credential

-DcomAuthentication

-Delay

-Impersonation

-Protocol

-Quiet

-Source

-ThrottleLimit

-TimeToLive

-WsmanAuthentication

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

ManagementObject

Per impostazione predefinita, questo cmdlet restituisce un oggetto Win32_PingStatus per ogni risposta ping.

System.Management.Automation.RemotingJob

Questo cmdlet restituisce un oggetto processo, se si specifica il parametro AsJob .

Boolean

Quando si usa il parametro Quiet , viene restituito un valore booleano . Se il cmdlet verifica più connessioni, restituisce una matrice di valori booleani .

Note

Questo cmdlet usa la classe Win32_PingStatus . Un Get-WMIObject Win32_PingStatus comando equivale a un Test-Connection comando.

Il set di parametri di origine è stato introdotto in PowerShell 3.0.

Collegamenti correlati

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