Test-Connection

Test-Connection [-ComputerName] <string[]> [[-Source] <string[]>] [-AsJob] [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-BufferSize <int>] [-Count <int>] [-Credential <PSCredential>] [-Delay <int>] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Quiet] [-ThrottleLimit <int>] [-TimeToLive <int>] [<CommonParameters>]

C:\PS>test-connection server01

Source        Destination     IPV4Address     IPV6Address  Bytes    Time(ms)
------        -----------     -----------     -----------  -----    --------
ADMIN1        Server01        157.59.137.44                32       0
ADMIN1        Server01        157.59.137.44                32       0
ADMIN1        Server01        157.59.137.44                32       0
ADMIN1        Server01        157.59.137.44                32       1

Beschreibung
-----------
Dieser Befehl sendet Echoanforderungspakete ("Pings") vom lokalen Computer an den Computer "Server01". Dieser Befehl gibt mit dem ComputerName-Parameter den Computer "Server01" an, der optionale Parametername wird jedoch weggelassen.

C:\PS>test-connection -computername server01, server02, server12 -credential domain01\user01

Beschreibung
-----------
Dieser Befehl sendet Pings vom lokalen Computer an mehrere Remotecomputer. Mit dem Credential-Parameter wird ein Benutzerkonto angegeben, das über die Berechtigung zum Pingen aller Remotecomputer verfügt.

C:\PS>test-connection -source Server02, Server 12, localhost -computername Server01

Beschreibung
-----------
Mit diesem Befehl werden Pings von unterschiedlichen Quellcomputern an einen einzelnen Remotecomputer (Server01) gesendet. Verwenden Sie diesen Befehl, um die Wartezeit von Verbindungen von mehreren Punkten aus zu überprüfen.

C:\PS>test-connection -computername Server01 -count 3 -delay 2 -TTL 256 -buffersize 256 -throttle 32

Beschreibung
-----------
Dieser Befehl sendet drei Pings vom lokalen Computer an den Computer "Server01". Der Befehl wird mit den Parametern von Test-Connection angepasst.

Verwenden Sie dieses Befehlsformat, wenn Sie erwarten, dass die Pingantwort aufgrund von vielen Hops oder einer Netzwerkverbindung mit viel Datenverkehr ungewöhnlich lange dauert.

C:\PS>$job = test-connection -computername (get-content servers.txt) -asjob

C:\PS> if ($job.jobstateinfo.state -ne "Running") {$results = receive-job $job}

Beschreibung
-----------
In diesem Beispiel wird das Ausführen des Befehls "Test-Connection" als Windows PowerShell-Hintergrundauftrag veranschaulicht. 

Mit dem ersten Befehl werden mithilfe des Cmdlets "Test-Connection" eine Vielzahl von Computern in einem Unternehmen gepingt. Bei dem Wert des ComputerName-Parameters handelt es sich um den Befehl "Get-Content", der eine Liste von Computernamen aus der Datei "Servers.txt" liest. Bei dem Befehl wird der Befehl mithilfe des AsJob-Parameters als Hintergrundauftrag ausgeführt.

Mit dem zweiten Befehl wird überprüft, ob der Auftrag nicht weiterhin ausgeführt wird. Wenn dies nicht der Fall ist, werden mit dem Befehl "Receive-Job" die Ergebnisse abgerufen und in der Variablen "$results" gespeichert.

C:\PS>test-connection Server55 -credential domain55\user01 -impersonation Identify

Beschreibung
-----------
Bei diesem Befehl wird ein Remotecomputer mit dem Cmdlet "Test-Connection" gepingt. Der Befehl gibt mithilfe des Credential-Parameters ein Benutzerkonto mit der Berechtigung zum Pingen des Remotecomputers an. Mit dem Impersonation-Parameter wird die Identitätswechselebene in "Identify" geändert.

C:\PS>if (test-connection -computername Server01 -quiet) {new-pssession Server01}

Beschreibung
-----------
Mit diesem Befehl wird nur dann eine PSSession auf "Server01" erstellt, wenn mindestens eines der an den Computer gesendeten Pings erfolgreich war.

Der Befehl verwendet das Cmdlet "Test-Connection", um den Computer "Server01" zu pingen. Der Befehl verwendet den Quiet-Parameter, der einen booleschen Wert zurückgibt, anstelle eines Win32_PingStatus-Objekts. Der Wert ist "$True", wenn einer der vier Ping-Befehle erfolgreich war, und andernfalls "false".

Wenn der Befehl "Test-Connection" den Wert "$True" zurückgibt, verwendet der Befehl das Cmdlet "New-PSSession", um PSSession zu erstellen.