Test-Connection

Başvuru

Modül:: Microsoft.PowerShell.Management

ICMP yankı isteği paketlerini veya ping'leri bir veya daha fazla bilgisayara gönderir.

Syntax

Test-Connection
    [-TargetName] <string[]>
    [-Ping]
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-MaxHops <int>]
    [-Count <int>]
    [-Delay <int>]
    [-BufferSize <int>]
    [-DontFragment]
    [-TimeoutSeconds <int>]
    [-Quiet]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -Repeat
    [-Ping]
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-MaxHops <int>]
    [-Delay <int>]
    [-BufferSize <int>]
    [-DontFragment]
    [-TimeoutSeconds <int>]
    [-Quiet]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -MtuSize
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-TimeoutSeconds <int>]
    [-Quiet]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -Traceroute
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-MaxHops <int>]
    [-TimeoutSeconds <int>]
    [-Quiet]
    [<CommonParameters>]

Test-Connection
    [-TargetName] <string[]>
    -TcpPort <int>
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-TimeoutSeconds <int>]
    [-Quiet]
    [<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 Test Bağlan ionCommand+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 bir dizi Test Bağlan ionCommand+PingStatus nesnesi gönderilir ve hedef makineden ping yanıtı başına bir nesne 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 -Wait

komutu, Start-Job bir kuruluştaki Test-Connection birçok bilgisayara ping göndermek için cmdlet'ini kullanır. TargetName parametresinin değeri, dosyadan Servers.txt bilgisayar adlarının listesini okuyan bir komutdurGet-Content. 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, Quiet parametresinin sağlandığı bilgisayara ping işlemiyle devam ederServer01. 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 PSSession oluşturmak için cmdlet'ini kullanırNew-PSSession.

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

Parametreler

-BufferSize

Bu komutla gönderilen arabelleğin boyutunu bayt cinsinden belirtir. Varsayılan değer 32'dir.

Type:	Int32
Aliases:	Size, Bytes, BS
Position:	Named
Default value:	32
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Count

Gönderilecek yankı isteklerinin sayısını belirtir. Varsayılan değer 4 şeklindedir.

Type:	Int32
Position:	Named
Default value:	4
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Delay

Pingler arasındaki aralığı saniye cinsinden belirtir.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv4

Cmdlet'i test için IPv4 protokollerini kullanmaya zorlar.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv6

Cmdlet'i test için IPv6 protokollerini kullanmaya zorlar.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Aliases:	Ttl, TimeToLive, Hops
Position:	Named
Default value:	128
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Aliases:	MtuSizeDetect
Position:	Named
Default value:	False
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Ping

Cmdlet'in ping testi gerçekleştirmesine neden olur. Bu, cmdlet için Test-Connection varsayılan moddur.

Type:	SwitchParameter
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Aliases:	Continuous
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	Local computer
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetName

Test etmek için bilgisayarlarını belirtir. Bilgisayar adlarını yazın veya IP adreslerini IPv4 veya IPv6 biçiminde yazın.

Type:	String[]
Aliases:	ComputerName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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ılabiliyorsa döndürülür $True .

Bağlantı kurulamıyorsa, $False döndürülür.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	5 seconds
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

TestConnectionCommand+PingStatus

Varsayılan olarak, bu cmdlet her ping yanıtı için bir Test Bağlan ionCommand+PingStatus nesnesi döndürür.

TestConnectionCommand+TraceStatus

Traceroute parametresini kullandığınızda, bu cmdlet yol boyunca her ping yanıtı için bir Test Bağlan ionCommand+TraceStatus nesnesi döndürür.

Boolean

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.

TestConnectionCommand+PingMtuStatus

MtuSize parametresini kullandığınızda, bu cmdlet her ping yanıtı için bir Test Bağlan ionCommand+PingMtuStatus nesnesi döndürür.

Test-Connection

Syntax

Description

Örnekler

Örnek 1: Uzak bilgisayara yankı istekleri gönderme

Örnek 2: Birkaç bilgisayara yankı istekleri gönderme

Örnek 3: Test komutunu özelleştirmek için parametreleri kullanma

Örnek 4: Arka plan işi olarak test çalıştırma

Örnek 5: Yalnızca bağlantı testi başarılı olursa oturum oluşturma

Örnek 6: Traceroute parametresini kullanma

Parametreler

-BufferSize

-Count

-Delay

-DontFragment

-IPv4

-IPv6

-MaxHops

-MtuSize

-Ping

-Quiet

-Repeat

-ResolveDestination

-Source

-TargetName

-TcpPort

-TimeoutSeconds

-Traceroute

Girişler

Çıkışlar

Geri Bildirim

Ek kaynaklar

Test-Connection

Syntax

Description

Örnekler

Örnek 1: Uzak bilgisayara yankı istekleri gönderme

Örnek 2: Birkaç bilgisayara yankı istekleri gönderme

Örnek 3: Test komutunu özelleştirmek için parametreleri kullanma

Örnek 4: Arka plan işi olarak test çalıştırma

Örnek 5: Yalnızca bağlantı testi başarılı olursa oturum oluşturma

Örnek 6: Traceroute parametresini kullanma

Parametreler

-BufferSize

-Count

-Delay

-DontFragment

-IPv4

-IPv6

-MaxHops

-MtuSize

-Ping

-Quiet

-Repeat

-ResolveDestination

-Source

-TargetName

-TcpPort

-TimeoutSeconds

-Traceroute

Girişler

Çıkışlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar