Test-Connection

Modül:

Microsoft.PowerShell.Management Module

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

Syntax

Default (Varsayılan)

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

Source

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

Quiet

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

Description

Test-Connection cmdlet'i bir veya daha fazla uzak bilgisayara İnternet Denetim İletisi Protokolü (ICMP) yankı isteği paketlerini 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.

Test-Connection parametrelerini 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.

Alıştığınız ping komutunun aksine, Test-Connection PowerShell'de araştırabileceğiniz bir Win32_PingStatus nesnesi döndürür. Quiet parametresi, test edilen her bağlantı için bir System.Boolean nesnesinde bir Boole değeri geri döndürür. Birden çok bağlantı test edilirse, 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 -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 Server01 bilgisayarını belirtmek için ComputerName parametresini kullanır.

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

Bu örnek, yerel bilgisayardan birkaç uzak bilgisayara ping gönderir.

Test-Connection -ComputerName Server01, Server02, Server12

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

Bu örnek, farklı kaynak bilgisayarlardan sunucu01 adlı tek bir uzak bilgisayara ping gönderir.

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

Test-Connection, kaynak bilgisayarlardan ping isteği gönderme izni olan bir kullanıcının kimlik bilgilerini belirtmek için Kimlik Bilgisi parametresini kullanır. Birden çok noktadan gelen bağlantıların gecikme süresini test etmek için bu komut biçimini kullanın.

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

Bu örnek, komutu özelleştirmek için Test-Connection parametrelerini kullanır. Yerel bilgisayar uzak bilgisayara ping testi gönderir.

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

Test-Connection Server01'i belirtmek için ComputerName parametresini kullanır. Sayısı parametresi, Server01 bilgisayarına üç ping gönderileceğini ve bunun Gecikme 2 saniyelik aralıklarla yapılacağını 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 5: Arka plan işi olarak test çalıştırma

Bu örnekte, powershell arka plan işi olarak bir Test-Connection komutunun nasıl çalıştırılır gösterilmektedir.

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

Test-Connection komutu, kuruluştaki birçok bilgisayara ping işlemi oluşturur. ComputerName parametresinin değeri, Get-Contentbilgisayar adlarının listesini okuyan bir Servers.txt file komutudur. Komut, AsJob parametresini kullanarak komutu arka plan işi olarak çalıştırır ve işi $job değişkenine kaydeder.

if komutu işin hala çalışmadığını denetler. İş çalışmıyorsa, Receive-Job sonuçları alır ve bunları $Results değişkeninde depolar.

Örnek 6: Kimlik bilgileriyle uzak bilgisayara ping işlemi

Bu komut, uzak bilgisayara ping göndermek için Test-Connection cmdlet'ini kullanır.

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

Komut, uzak bilgisayara ping işlemi izni olan bir kullanıcı hesabı belirtmek için Kimlik Bilgisi parametresini ve kimliğe bürünme düzeyiniTanımla olarak değiştirmek için Kimliğe Bürünme parametresini belirtir.

Örnek 7: 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 -ComputerName Server01 -Quiet) {New-PSSession Server01}

if komutu, Server01 bilgisayarına ping göndermek için Test-Connection cmdlet'ini kullanır. komut, Win32_PingStatus nesnesi yerine Boole değeri döndüren Quiet parametresini kullanır. Dört ping'in başarılı olması durumunda değer $true, aksi takdirde $false.

Test-Connection komutu $truedeğerini döndürürse, komut New-PSSessionoluşturmak için cmdlet'ini kullanır.

Parametreler

-AsJob

Bu cmdlet'in arka plan işi olarak çalıştığını gösterir. AsJob parametresini belirttiğinizde, komut hemen arka plan işini temsil eden bir nesne döndürür. İş tamamlarken oturumda çalışmaya devam edebilirsiniz. İş sonuçlarını almak için Receive-Job cmdlet'ini kullanın.

PowerShell arka plan işleri hakkında daha fazla bilgi için bkz. about_Jobs ve about_Remote_Jobs.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Default

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

Source

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-BufferSize

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

Parametre özellikleri

Tür:	Int32
Default value:	32
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Boyut, byte, BSc

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ComputerName

Ping atacak bilgisayarları belirtir. Bilgisayar adlarını yazın veya IP adreslerini IPv4 veya IPv6 biçiminde yazın. Joker karakterlere izin verilmez. Bu parametre gereklidir.

Bu parametre PowerShell uzaktan iletişimini desteklemez. Bilgisayarınız uzak komutları çalıştıracak şekilde yapılandırılmamış olsa bile ComputerName parametresini kullanabilirsiniz.

Uyarı

ComputerName parametresi, PowerShell 6.0 ve üzeri sürümlerde TargetName olarak yeniden adlandırılır.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Çin, IP Adresi, __SUNUCU, Sunucu, Varış Yeri

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Count

Gönderilecek yankı isteklerinin sayısını belirtir. Varsayılan değer 4'dür.

Parametre özellikleri

Tür:	Int32
Default value:	4
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

Kaynak bilgisayardan ping isteği gönderme izni olan bir kullanıcı hesabı belirtir. User01 veya Domain01\User01 gibi bir kullanıcı adı yazın veya cmdlet'inden bir tane gibi Get-Credential nesnesi girin.

Kimlik Bilgisi parametresi yalnızca komutta Source parametresi kullanıldığında geçerlidir. Kimlik bilgileri hedef bilgisayarı etkilemez.

Parametre özellikleri

Tür:	PSCredential
Default value:	Current user
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Source

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DcomAuthentication

Bu cmdlet'in WMI ile kullandığı kimlik doğrulama düzeyini belirtir. Test-Connection WMI kullanır. Bu parametre için kabul edilebilir değerler şunlardır:

• Varsayılan. Windows Kimlik Doğrulaması
• None. COM kimlik doğrulaması yok
• Bağlan. Bağlantı düzeyi COM kimlik doğrulaması
• Ara. Çağrı düzeyi COM kimlik doğrulaması
• Paket. Paket düzeyinde COM kimlik doğrulaması
• PacketIntegrity. Paket Bütünlük düzeyi COM kimlik doğrulaması
• PacketPrivacy. Paket Gizlilik düzeyi COM kimlik doğrulaması
• Değişmedi. Önceki komutla aynı

Varsayılan değer, 4numaralandırılmış değerine sahip Packet değeridir. Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. AuthenticationLevel numaralandırmasını .

Parametre özellikleri

Tür:	AuthenticationLevel
Default value:	Packet (enumerated value of 4)
Kabul edilen değerler:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Kimlik doğrulama

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Delay

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

Parametre özellikleri

Tür:	Int32
Default value:	1 (second)
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Impersonation

Bu cmdlet WMI'yi çağırırken kullanılacak kimliğe bürünme düzeyini belirtir. Test-Connection WMI kullanır.

Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:

• Varsayılan. Varsayılan kimliğe bürünme.
• Anonim. Çağıranın kimliğini gizler.
• tanımlayın. Nesnelerin çağıranın kimlik bilgilerini sorgulamasına izin verir.
• Kimliğine Bürün. Nesnelerin çağıranın kimlik bilgilerini kullanmasına izin verir.

Varsayılan değer Kimliğe Büründeğeridir.

Parametre özellikleri

Tür:	ImpersonationLevel
Default value:	Impersonate
Kabul edilen değerler:	Default, Anonymous, Identify, Impersonate, Delegate
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Protocol

Bir protokol belirtir. Bu parametre için kabul edilebilir değerler DCOM ve WSMan'dır.

Parametre özellikleri

Tür:	String
Default value:	None
Kabul edilen değerler:	DCOM, WSMan
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Quiet

Quiet parametresi, System.Boolean nesnesinde 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. ComputerName parametresi birden çok bilgisayar belirtiyorsa, Boole değerleri dizisi döndürülür.

ping başarılı olursa döndürülür.

Tüm ping'leri başarısız olursa döndürülür.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Quiet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Source

Ping'in kaynaklandığı bilgisayarların adlarını belirtir. Bilgisayar adlarının virgülle ayrılmış bir listesini girin. Varsayılan değer yerel bilgisayardır.

Parametre özellikleri

Tür:	String[]
Default value:	Local computer
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	FCN, SRC

Parametre kümeleri

Source

Position:	1
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ThrottleLimit

Bu komutu çalıştırmak için oluşturulabilecek en fazla eşzamanlı bağlantı sayısını belirtir. Bu parametreyi atlar veya 0 değerini girerseniz, varsayılan değer olan 32 kullanılır.

Hız sınırlaması yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.

Parametre özellikleri

Tür:	Int32
Default value:	32
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Default

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

Source

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TimeToLive

Bir paketin en fazla kaç kez iletilebileceğini belirtir. Ağ geçitlerindeki, yönlendiricilerdeki vb. her atlama için TimeToLive değeri bir azaltılır. Sıfırda paket atılır ve bir hata döndürülür. Windows'de varsayılan değer 128. TimeToLive parametresinin diğer adı TTL.

Parametre özellikleri

Tür:	Int32
Default value:	128 in Windows
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	TTL

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WsmanAuthentication

Bu cmdlet WSMan protokolunu kullandığında kullanıcı kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

• Temel
• CredSSP
• Varsayılan
• Özet
• Kerberos Gölü
• Anlaşma.

Varsayılan değer "Default" olarak ayarlanmıştır.

Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. Kimlik Doğrulama Mekanizması Enumerasyonu.

Dikkat: Kullanıcı kimlik bilgilerinin doğrulanmak üzere uzak bir bilgisayara geçirildiği Kimlik Bilgileri Güvenlik Hizmeti Sağlayıcısı (CredSSP) kimlik doğrulaması, uzak ağ paylaşımına erişim gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, bu bilgisayara geçirilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	String
Default value:	Default
Kabul edilen değerler:	Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

ManagementObject

Varsayılan olarak, bu cmdlet her ping yanıtı için bir Win32_PingStatus nesnesi döndürür.

System.Management.Automation.RemotingJob

AsJob parametresini belirtirseniz, bu cmdlet bir iş nesnesi döndürür.

Boolean

Quiet parametresini kullandığınızda, bu bir Boole değeri döndürür. Cmdlet birden çok bağlantıyı test ederse, boole değerlerinden oluşan bir dizi döndürür.

Notlar

Bu cmdlet Win32_PingStatus sınıfını kullanır. Get-WmiObject Win32_PingStatus komutu, Test-Connection komutuna eşdeğerdir.

Kaynak parametre kümesi PowerShell 3.0'da kullanıma sunulmuştur.

İlişkili Bağlantılar

• Bilgisayar Ekle
• Bilgisayarı Yeniden Başlat
• Bilgisayarı Durdur