Test-Connection
ICMP yankı isteği paketlerini veya ping'leri bir veya daha fazla bilgisayara gönderir.
Sözdizimi
Test-Connection
[-TargetName] <string[]>
[-Ping]
[-IPv4]
[-IPv6]
[-ResolveDestination]
[-Source <string>]
[-MaxHops <int>]
[-Count <int>]
[-Delay <int>]
[-BufferSize <int>]
[-DontFragment]
[-Quiet]
[-TimeoutSeconds <int>]
[<CommonParameters>]Test-Connection
[-TargetName] <string[]>
-Repeat
[-Ping]
[-IPv4]
[-IPv6]
[-ResolveDestination]
[-Source <string>]
[-MaxHops <int>]
[-Delay <int>]
[-BufferSize <int>]
[-DontFragment]
[-Quiet]
[-TimeoutSeconds <int>]
[<CommonParameters>]Test-Connection
[-TargetName] <string[]>
-Traceroute
[-IPv4]
[-IPv6]
[-ResolveDestination]
[-Source <string>]
[-MaxHops <int>]
[-Quiet]
[-TimeoutSeconds <int>]
[<CommonParameters>]Test-Connection
[-TargetName] <string[]>
-MtuSize
[-IPv4]
[-IPv6]
[-ResolveDestination]
[-Quiet]
[-TimeoutSeconds <int>]
[<CommonParameters>]Test-Connection
[-TargetName] <string[]>
-TcpPort <int>
[-IPv4]
[-IPv6]
[-ResolveDestination]
[-Source <string>]
[-Count <int>]
[-Delay <int>]
[-Repeat]
[-Quiet]
[-TimeoutSeconds <int>]
[-Detailed]
[<CommonParameters>]Description
Cmdlet, Test-Connection bir veya daha fazla uzak bilgisayara İnternet Denetim İletisi Protokolü (ICMP) yankı isteği paketleri veya ping'leri gönderir ve yankı yanıtı yanıtlarını döndürür. Bu cmdlet'i, belirli bir bilgisayara bir IP ağı üzerinden ulaşılıp bağlanılamayacağını belirlemek için kullanabilirsiniz.
parametresini Test-Connection kullanarak hem gönderen hem de alan bilgisayarları belirtebilir, komutu arka plan işi olarak çalıştırabilir, zaman aşımı ve ping sayısını ayarlayabilir ve bağlantı ile kimlik doğrulamasını yapılandırabilirsiniz.
Tanıdık ping komutunun aksine, Test-Connection PowerShell'de araştırabileceğiniz bir TestConnectionCommand+PingStatus nesnesi döndürür. Quiet parametresi, test edilen her bağlantı için System.Boolean nesnesinde bir Boole değeri döndürür. Birden çok bağlantı test edilirse bir Boole değerleri dizisi döndürülür.
Örnekler
Örnek 1: Uzak bilgisayara yankı istekleri gönderme
Bu örnek, yerel bilgisayardan Server01 bilgisayarına yankı isteği paketleri gönderir.
Test-Connection -TargetName Server01 -IPv4
Destination: Server01
Ping Source Address Latency BufferSize Status
(ms) (B)
---- ------ ------- ------- ---------- ------
1 ADMIN1 10.59.137.44 24 32 Success
2 ADMIN1 10.59.137.44 39 32 Success
3 ADMIN1 * * * TimedOut
4 ADMIN1 10.59.137.44 28 32 Success
Test-Connection , Server01 bilgisayarını belirtmek için TargetName parametresini kullanır.
IPv4 parametresi test için protokolü belirtir.
Çıkış akışına , hedef makineden ping yanıtı başına bir nesne olmak üzere bir dizi TestConnectionCommand+PingStatus nesnesi gönderilir.
Örnek 2: Birkaç bilgisayara yankı istekleri gönderme
Bu örnek, yerel bilgisayardan birkaç uzak bilgisayara ping gönderir.
Test-Connection -TargetName Server01, Server02, Server12Örnek 3: Test komutunu özelleştirmek için parametreleri kullanma
Bu örnekte komutunu özelleştirmek için parametresi Test-Connection kullanılır. Yerel bilgisayar uzak bilgisayara ping testi gönderir.
Test-Connection -TargetName Server01 -Count 3 -Delay 2 -MaxHops 255 -BufferSize 256
Test-Connection
, Server01'i belirtmek için TargetName parametresini kullanır.
Count parametresi, Server01 bilgisayarına 2 saniyelik aralıklarla üç ping gönderileceğini belirtir.
Ping yanıtının normalden daha uzun sürmesi beklendiğinde, uzun sayıda atlama veya yüksek trafikli bir ağ koşulu nedeniyle bu seçenekleri kullanabilirsiniz.
Örnek 4: Arka plan işi olarak test çalıştırma
Bu örnekte, bir Test-Connection komutun PowerShell arka plan işi olarak nasıl çalıştırılacakları gösterilmektedir.
$job = Start-Job -ScriptBlock { Test-Connection -TargetName (Get-Content -Path "Servers.txt") }
$Results = Receive-Job $job -Waitkomutu, Start-Job bir kuruluştaki Test-Connection birçok bilgisayara ping göndermek için cmdlet'ini kullanır.
TargetName parametresinin komutu cmdlet'ini Start-Job kullanarak komutu arka plan işi olarak çalıştırır ve işi değişkene $job kaydeder.
Receive-Job İş tamamlanana kadar komutuna -Wait yönerge gönderilir ve ardından sonuçları alır ve bunları değişkende $Results depolar.
Örnek 5: Yalnızca bağlantı testi başarılı olursa oturum oluşturma
Bu örnek, Server01 bilgisayarında yalnızca bilgisayara gönderilen pinglerin en az biri başarılı olursa bir oturum oluşturur.
if (Test-Connection -TargetName Server01 -Quiet) { New-PSSession -ComputerName Server01 }
Test-Connection cmdlet'i, QuietServer01sağlandığı bilgisayara ping işlemiyle devam eder.
Sonuçta elde edilen değer, dört ping'in başarılı olmasıdır $True . Pinglerin hiçbiri başarılı olmazsa, değeri olur $False.
Test-Connection komutu değerini $Truedöndürürse, komut PSSessionNew-PSSessionkullanır.
Örnek 6: Traceroute parametresini kullanma
PowerShell 6.0'da kullanıma sunulan Traceroute parametresi, targetName parametresiyle belirttiğiniz uzak hedef ile yerel bilgisayar arasındaki bir yolu eşler.
Test-Connection -TargetName www.google.com -Traceroute
Target: google.com
Hop Hostname Ping Latency Status Source TargetAddress
(ms)
--- -------- ---- ------- ------ ------ -------------
1 172.20.0.1 1 4 Success Lira 172.217.9.174
1 172.20.0.1 2 3 Success Lira 172.217.9.174
1 172.20.0.1 3 2 Success Lira 172.217.9.174
2 12.108.153.193 1 3 Success Lira 172.217.9.174
2 12.108.153.193 2 3 Success Lira 172.217.9.174
2 12.108.153.193 3 2 Success Lira 172.217.9.174
3 12.244.85.177 1 11 Success Lira 172.217.9.174
3 12.244.85.177 2 12 Success Lira 172.217.9.174
3 12.244.85.177 3 12 Success Lira 172.217.9.174
4 * 1 14 DestinationNetw… Lira 172.217.9.174
4 * 2 * TimedOut Lira 172.217.9.174
4 * 3 20 DestinationNetw… Lira 172.217.9.174
5 * 1 * TimedOut Lira 172.217.9.174
5 * 2 15 DestinationNetw… Lira 172.217.9.174
5 * 3 * TimedOut Lira 172.217.9.174
6 * 1 18 DestinationNetw… Lira 172.217.9.174
6 * 2 * TimedOut Lira 172.217.9.174
6 * 3 16 DestinationNetw… Lira 172.217.9.174
7 * 1 * TimedOut Lira 172.217.9.174
7 * 2 * TimedOut Lira 172.217.9.174
7 * 3 * TimedOut Lira 172.217.9.174
8 * 1 * TimedOut Lira 172.217.9.174
8 * 2 * TimedOut Lira 172.217.9.174
8 * 3 * TimedOut Lira 172.217.9.174
9 * 1 * TimedOut Lira 172.217.9.174
9 * 2 * TimedOut Lira 172.217.9.174
9 * 3 * TimedOut Lira 172.217.9.174
10 * 1 * TimedOut Lira 172.217.9.174
10 * 2 * TimedOut Lira 172.217.9.174
10 * 3 * TimedOut Lira 172.217.9.174
11 172.217.9.174 1 23 Success Lira 172.217.9.174
11 172.217.9.174 2 21 Success Lira 172.217.9.174
11 172.217.9.174 3 22 Success Lira 172.217.9.174
Test-Connection Komutu Traceroute parametresiyle çağrılır. Nesneler olan [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus] sonuçlar, Başarı çıkış akışına çıkıştır.
Örnek 7: TCP bağlantı testi için ayrıntılı çıkış alma
Detailed parametresini kullandığınızda, bu cmdlet TCP bağlantı girişimlerinin durumu hakkında ayrıntılı bir bilgi döndürür.
Test-Connection bing.com -TCPPort 443 -Detailed -Count 4
Target: bing.com
Id Source Address Port Latency(ms) Connected Status
-- ------ ------- ---- ----------- --------- ------
1 circumflex 2620:1ec:c11::200 443 12 True Success
2 circumflex 2620:1ec:c11::200 443 14 True Success
3 circumflex 2620:1ec:c11::200 443 17 True Success
4 circumflex 2620:1ec:c11::200 443 17 True SuccessParametreler
-BufferSize
Bu komutla gönderilen arabelleğin boyutunu bayt cinsinden belirtir. Varsayılan değer 32'dir.
| Tür: | Int32 |
| Diğer adlar: | Size, Bytes, BS |
| Position: | Named |
| Default value: | 32 |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Count
Gönderilecek yankı isteklerinin sayısını belirtir. Varsayılan değer 4 şeklindedir.
| Tür: | Int32 |
| Position: | Named |
| Default value: | 4 |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Delay
Pingler arasındaki aralığı saniye cinsinden belirtir.
| Tür: | Int32 |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Detailed
Detailed parametresini kullandığınızda, bu cmdlet TCP bağlantı girişimlerinin durumu hakkında ayrıntılı bir bilgi döndürür.
Bu parametre PowerShell 7.4'e eklendi.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-DontFragment
Bu parametre, IP üst bilgisinde Parçalanma bayrağını ayarlar. Bu parametreyi BufferSize parametresiyle kullanarak Yol MTU boyutunu test edebilirsiniz. Yol MTU hakkında daha fazla bilgi için wikipedia'daki Yol MTU Bulma makalesine bakın.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-IPv4
Cmdlet'i test için IPv4 protokollerini kullanmaya zorlar.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-IPv6
Cmdlet'i test için IPv6 protokollerini kullanmaya zorlar.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-MaxHops
ICMP istek iletisinin gönderilebileceği en fazla atlama sayısını ayarlar. Varsayılan değer işletim sistemi tarafından denetlener. Windows 10 ve üzeri için varsayılan değer 128 atlamadır.
| Tür: | Int32 |
| Diğer adlar: | Ttl, TimeToLive, Hops |
| Position: | Named |
| Default value: | 128 |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-MtuSize
Bu parametre Yol MTU boyutunu bulmak için kullanılır. Cmdlet, hedefe giden Yol MTU boyutunu içeren bir PingReply#MTUSize nesnesi döndürür. Yol MTU hakkında daha fazla bilgi için wikipedia'daki Yol MTU Bulma makalesine bakın.
| Tür: | SwitchParameter |
| Diğer adlar: | MtuSizeDetect |
| Position: | Named |
| Default value: | False |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Ping
Cmdlet'in ping testi gerçekleştirmesine neden olur. Bu, cmdlet için Test-Connection varsayılan moddur.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | True |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Quiet
Quiet parametresi bir Boole değeri döndürür. Bu parametrenin kullanılması tüm hataları gizler.
Test edilen her bağlantı bir Boole değeri döndürür. TargetName parametresi birden çok bilgisayar belirtiyorsa bir Boole değerleri dizisi döndürülür.
Belirli bir hedefe yapılan herhangi bir ping başarılı olursa, $True döndürülür.
Belirli bir hedefe yapılan tüm ping işlemleri başarısız olursa döndürülür$False.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Repeat
Cmdlet'in sürekli ping istekleri göndermesine neden olur. TargetName değeri bir hedef dizisi olduğunda, cmdlet yalnızca ilk hedef için ping isteklerini yineler. Kalan hedefleri yoksayar. Bu parametre Count parametresiyle kullanılamaz.
| Tür: | SwitchParameter |
| Diğer adlar: | Continuous |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-ResolveDestination
Cmdlet'in hedefin DNS adını çözümlemeye çalışmasına neden olur. Traceroute parametresiyle birlikte kullanıldığında, mümkünse tüm ara konakların DNS adları da alınır.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Source
Ping'in kaynaklandığı bilgisayarların adlarını belirtir. Bilgisayar adlarının virgülle ayrılmış bir listesini girin. Varsayılan, yerel bilgisayardır.
Not
Bu parametre PowerShell 6 ve daha yeni sürümlerde desteklenmez. Bu parametrenin girilmesi hataya neden olur.
| Tür: | String |
| Position: | Named |
| Default value: | Local computer |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-TargetName
Test etmek için bilgisayarlarını belirtir. Bilgisayar adlarını yazın veya IP adreslerini IPv4 veya IPv6 biçiminde yazın.
| Tür: | String[] |
| Diğer adlar: | ComputerName |
| Position: | 0 |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-TcpPort
TCP bağlantı testinde kullanılacak hedefteki TCP bağlantı noktası numarasını belirtir.
Cmdlet, hedefte belirtilen bağlantı noktasına TCP bağlantısı kurmaya çalışır.
- Bağlantı yapılırsa cmdlet'i döndürür
$True. - Bağlantı yapılmazsa cmdlet döndürülüyor
$False.
| Tür: | Int32 |
| Position: | Named |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-TimeoutSeconds
Test için zaman aşımı değerini ayarlar. Zaman aşımı süresi dolmadan yanıt alınmazsa test başarısız olur. Varsayılan değer beş saniyedir.
Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.
| Tür: | Int32 |
| Position: | Named |
| Default value: | 5 seconds |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Traceroute
Cmdlet'in izleme yolu testi gerçekleştirmesine neden olur. Bu parametre kullanıldığında, cmdlet bir TestConnectionCommand+TraceStatus nesne döndürür.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
Microsoft.PowerShell.Commands.TestConnectionCommand+PingStatus
Varsayılan olarak, bu cmdlet her ping yanıtı için bir TestConnectionCommand+PingStatus nesnesi döndürür.
Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus
Traceroute parametresini kullandığınızda, bu cmdlet yol boyunca her ping yanıtı için bir TestConnectionCommand+TraceStatus nesnesi döndürür.
Quiet veya TcpPort parametrelerini kullandığınızda, bu cmdlet bir Booledeğeri döndürür. Cmdlet birden çok bağlantıyı test ederse bir Boole değerleri dizisi döndürür.
Microsoft.PowerShell.Commands.TestConnectionCommand+PingMtuStatus
MtuSize parametresini kullandığınızda, bu cmdlet her ping yanıtı için bir TestConnectionCommand+PingMtuStatus nesnesi döndürür.
Microsoft.PowerShell.Commands.TestConnectionCommand+TcpPortStatus
Detailed parametresini kullandığınızda, bu cmdlet TCP bağlantısının durumunu gösteren bir TestConnectionCommand+TcpPortStatus nesnesi döndürür.
Notlar
Linux'ta, BufferSize parametresini veya MtuSize parametresiyle birleştirilen herhangi bir parametre kombinasyonunu kullanmak, 32 baytlık varsayılan olmayan bir arabellek boyutuna yol açarsa sudogerektirebilir. Bu gibi durumlarda, Test-Command gerekli olduğunu sudo belirten bir ileti ile bir özel durum oluşturur.
