Test-Connection

Modul:

Microsoft.PowerShell.Management Module

Mengirim paket permintaan gema ICMP, atau ping, ke satu atau beberapa komputer.

Sintaks

Default (Default)

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

Deskripsi

Cmdlet Test-Connection mengirim paket permintaan gema Internet Control Message Protocol (ICMP), atau ping, ke satu atau beberapa komputer jarak jauh dan mengembalikan balasan respons gema. Anda dapat menggunakan cmdlet ini untuk menentukan apakah komputer tertentu dapat dihubungi di seluruh jaringan IP.

Anda dapat menggunakan parameter Test-Connection untuk menentukan komputer pengiriman dan penerimaan, untuk menjalankan perintah sebagai pekerjaan latar belakang, untuk mengatur batas waktu dan jumlah ping, dan untuk mengonfigurasi koneksi dan autentikasi.

Tidak seperti perintah ping yang sudah dikenal, mengembalikan objek Win32_PingStatus yang dapat Anda selidiki di PowerShell. Parameter Tenang mengembalikan nilai Boolean dalam objek System.Boolean untuk setiap koneksi yang diuji. Jika beberapa koneksi diuji, sebuah array berisi nilai Boolean dikembalikan.

Contoh

Contoh 1: Mengirim permintaan echo ke komputer jarak jauh

Contoh ini mengirimkan paket permintaan echo dari komputer lokal ke komputer 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

menggunakan parameter ComputerName untuk menentukan komputer Server01.

Contoh 2: Mengirim permintaan echo ke beberapa komputer

Contoh ini mengirim ping dari komputer lokal ke beberapa komputer jarak jauh.

Test-Connection -ComputerName Server01, Server02, Server12

Contoh 3: Mengirim permintaan echo dari beberapa komputer ke komputer

Contoh ini mengirim ping dari komputer sumber yang berbeda ke satu komputer jarak jauh, Server01.

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

menggunakan parameter Kredensial untuk menentukan kredensial pengguna yang memiliki izin untuk mengirim permintaan ping dari komputer sumber. Gunakan format perintah ini untuk menguji latensi koneksi dari beberapa titik.

Contoh 4: Menggunakan parameter untuk menyesuaikan perintah pengujian

Contoh ini menggunakan parameter Test-Connection untuk menyesuaikan perintah. Komputer lokal mengirim pengujian ping ke komputer jarak jauh.

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

Test-Connectionmenggunakan parameter ComputerName untuk menentukan Server01. Parameter Count menentukan tiga ping dikirim ke komputer Server01 dengan interval penundaan 2 detik .

Anda mungkin menggunakan opsi ini ketika respons ping diperkirakan akan memakan waktu lebih lama dari biasanya, baik karena jumlah hop yang diperluas atau kondisi jaringan lalu lintas tinggi.

Contoh 5: Jalankan pengujian sebagai pekerjaan latar belakang

Contoh ini memperlihatkan cara menjalankan perintah Test-Connection sebagai pekerjaan latar belakang PowerShell.

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

Perintah Test-Connection melakukan ping pada banyak komputer di perusahaan. Nilai parameter ComputerName adalah perintah yang membaca daftar nama komputer dari . Perintah menggunakan parameter AsJob untuk menjalankan perintah sebagai pekerjaan latar belakang dan menyimpan pekerjaan dalam variabel $job.

Perintah if memeriksa untuk melihat bahwa pekerjaan tidak masih berjalan. Jika pekerjaan tidak berjalan, Receive-Job mendapatkan hasilnya dan menyimpannya dalam variabel $Results.

Contoh 6: Ping komputer jarak jauh dengan kredensial

Perintah ini menggunakan cmdlet Test-Connection untuk melakukan ping komputer jarak jauh.

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

Perintah menggunakan parameter Kredensial untuk menentukan akun pengguna yang memiliki izin untuk melakukan ping komputer jarak jauh dan parameter Peniruan untuk mengubah tingkat peniruan menjadi Identifikasi.

Contoh 7: Buat sesi hanya jika pengujian koneksi berhasil

Contoh ini membuat sesi di komputer Server01 hanya jika setidaknya salah satu ping yang dikirim ke komputer berhasil.

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

Perintah if menggunakan cmdlet Test-Connection untuk melakukan ping komputer Server01. Perintah menggunakan parameter Diam , yang mengembalikan nilai Boolean , bukan objek Win32_PingStatus. Nilainya $true jika salah satu dari empat ping berhasil dan, jika tidak, $false.

Jika perintah Test-Connection mengembalikan nilai $true, perintah menggunakan cmdlet New-PSSession untuk membuat PSSession .

Parameter

-AsJob

Menunjukkan bahwa cmdlet ini berjalan sebagai pekerjaan latar belakang. Saat Anda menentukan parameter AsJob, perintah segera mengembalikan objek yang mewakili pekerjaan latar belakang. Anda dapat terus bekerja dalam sesi saat pekerjaan selesai. Untuk mendapatkan hasil pekerjaan, gunakan cmdlet Receive-Job.

Untuk informasi selengkapnya tentang pekerjaan latar belakang PowerShell, lihat about_Jobs dan about_Remote_Jobs.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Default

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

Source

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-BufferSize

Menentukan ukuran, dalam byte, dari buffer yang dikirim dengan perintah ini. Nilai defaultnya adalah 32.

Properti parameter

Jenis:	Int32
Nilai default:	32
Mendukung wildcard:	False
DontShow:	False
Alias:	Ukuran, Bita, BS

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ComputerName

Menentukan komputer ke ping. Ketik nama komputer atau ketik alamat IP dalam format IPv4 atau IPv6. Karakter kartubebas tidak diizinkan. Parameter ini diperlukan.

Parameter ini tidak bergantung pada remoting PowerShell. Anda dapat menggunakan parameter ComputerName meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

Nota

Parameter ComputerName diganti namanya menjadi TargetName di PowerShell 6.0 ke atas.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	CN, Alamat IP, __PELADEN, pelayan, Tujuan

Kumpulan parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Count

Menentukan jumlah permintaan echo yang akan dikirim. Nilai defaultnya adalah 4.

Properti parameter

Jenis:	Int32
Nilai default:	4
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Credential

Menentukan akun pengguna yang memiliki izin untuk mengirim permintaan ping dari komputer sumber. Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential , seperti dari cmdlet .

Parameter Kredensial hanya valid ketika parameter Sumber digunakan dalam perintah. Kredensial tidak memengaruhi komputer tujuan.

Properti parameter

Jenis:	PSCredential
Nilai default:	Current user
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Source

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DcomAuthentication

Menentukan tingkat autentikasi yang digunakan cmdlet ini dengan WMI. Test-Connection menggunakan WMI. Nilai yang dapat diterima untuk parameter ini adalah:

• Default. Autentikasi Windows
• Tidak ada. Tidak ada autentikasi COM
• Sambungkan. Autentikasi COM tingkat sambungkan
• Telepon aku. Autentikasi COM tingkat panggilan
• Paket. Autentikasi COM tingkat paket
• PacketIntegrity. Autentikasi COM tingkat Integritas Paket
• PacketPrivacy. Autentikasi COM tingkat privasi paket
• Tidak berubah. Sama seperti perintah sebelumnya

Nilai defaultnya adalah Paket yang memiliki nilai enumerasi 4. Untuk informasi selengkapnya tentang nilai parameter ini, lihat enumerasi AuthenticationLevel.

Properti parameter

Jenis:	AuthenticationLevel
Nilai default:	Packet (enumerated value of 4)
Nilai yang diterima:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Mendukung wildcard:	False
DontShow:	False
Alias:	Otentikasi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Delay

Menentukan interval antara ping, dalam hitungan detik.

Properti parameter

Jenis:	Int32
Nilai default:	1 (second)
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Impersonation

Menentukan tingkat peniruan untuk digunakan ketika cmdlet ini memanggil WMI. Test-Connection menggunakan WMI.

Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:

• Default. Peniruan default.
• Anonim. Menyembunyikan identitas pemanggil.
• Identifikasi. Memungkinkan objek untuk mengkueri kredensial pemanggil.
• Meniru. Memungkinkan objek menggunakan kredensial pemanggil.

Nilai defaultnya adalah Meniru.

Properti parameter

Jenis:	ImpersonationLevel
Nilai default:	Impersonate
Nilai yang diterima:	Default, Anonymous, Identify, Impersonate, Delegate
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Protocol

Menentukan protokol. Nilai yang dapat diterima untuk parameter ini adalah DCOM dan WSMan.

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	DCOM, WSMan
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Quiet

Parameter Quiet mengembalikan nilai Boolean dalam objek System.Boolean. Menggunakan parameter ini menekan semua kesalahan.

Setiap koneksi yang diuji mengembalikan nilai Boolean. Jika parameter ComputerName menentukan beberapa komputer, array nilai Boolean dikembalikan.

Jika ping berhasil, $true dikembalikan.

Jika semua ping gagal, $false dikembalikan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Quiet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Source

Menentukan nama komputer tempat ping berasal. Masukkan daftar nama komputer yang dipisahkan koma. Defaultnya adalah komputer lokal.

Properti parameter

Jenis:	String[]
Nilai default:	Local computer
Mendukung wildcard:	False
DontShow:	False
Alias:	FCN, SRC

Kumpulan parameter

Source

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ThrottleLimit

Menentukan jumlah maksimum koneksi bersamaan yang dapat dibuat untuk menjalankan perintah ini. Jika Anda menghilangkan parameter ini atau memasukkan nilai 0, nilai default, 32, digunakan.

Batas pembatasan hanya berlaku untuk perintah saat ini, bukan ke sesi atau ke komputer.

Properti parameter

Jenis:	Int32
Nilai default:	32
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Default

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

Source

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-TimeToLive

Menentukan waktu maksimum paket dapat diteruskan. Untuk setiap lompatan di gateway, router dll. nilai TimeToLive dikurangi satu. Pada nol paket dibuang dan kesalahan dikembalikan. Di Windows, Nilai defaultnya adalah 128. Alias parameter TimeToLive TTL .

Properti parameter

Jenis:	Int32
Nilai default:	128 in Windows
Mendukung wildcard:	False
DontShow:	False
Alias:	TTL

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WsmanAuthentication

Menentukan mekanisme yang digunakan untuk mengautentikasi kredensial pengguna ketika cmdlet ini menggunakan protokol WSMan. Nilai yang dapat diterima untuk parameter ini adalah:

• Dasar
• CredSSP
• Bawaan
• ringkasan
• Kerberos
• Berunding.

Nilai defaultnya adalah Default.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism Enumeration.

Perhatian: Autentikasi Penyedia Layanan Keamanan Kredensial (CredSSP), di mana kredensial pengguna diteruskan ke komputer jarak jauh untuk diautentikasi, dirancang untuk perintah yang memerlukan autentikasi pada lebih dari satu sumber daya, seperti mengakses berbagi jaringan jarak jauh. Mekanisme ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, kredensial yang diteruskan ke komputer jarak jauh dapat digunakan untuk mengontrol sesi jaringan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	String
Nilai default:	Default
Nilai yang diterima:	Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

ManagementObject

Secara default, cmdlet ini mengembalikan objek Win32_PingStatus untuk setiap balasan ping.

System.Management.Automation.RemotingJob

Cmdlet ini mengembalikan objek pekerjaan, jika Anda menentukan parameter AsJob.

Boolean

Saat Anda menggunakan parameter Tenang , ini mengembalikan nilai Boolean . Jika cmdlet menguji beberapa koneksi, maka cmdlet tersebut mengembalikan array dari nilai Boolean .

Catatan

Cmdlet ini menggunakan kelas Win32_PingStatus. Perintah Get-WmiObject Win32_PingStatus setara dengan perintah Test-Connection.

Kumpulan parameter Sumber diperkenalkan di PowerShell 3.0.

Link Terkait

• Add-Computer
• Mulai Ulang Komputer
• Matikan-Komputer