Test-Connection

Modul:

Microsoft.PowerShell.Management Module

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

Sintaks

DefaultPing (Default)

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

RepeatPing

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

TraceRoute

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

MtuSizeDetect

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

TcpPort

Test-Connection
    [-TargetName] <string[]>
    -TcpPort <int>
    [-IPv4]
    [-IPv6]
    [-ResolveDestination]
    [-Source <string>]
    [-Count <int>]
    [-Delay <int>]
    [-Repeat]
    [-Quiet]
    [-TimeoutSeconds <int>]
    [-Detailed]
    [<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 TestConnectionCommand+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 -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

menggunakan parameter TargetName untuk menentukan komputer Server01. Parameter IPv4 menentukan protokol untuk pengujian.

Serangkaian objek TestConnectionCommand+PingStatus dikirim ke aliran output, satu objek per balasan ping dari komputer target.

Contoh 2: Mengirim permintaan echo ke beberapa komputer

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

Test-Connection -TargetName Server01, Server02, Server12

Contoh 3: 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 -TargetName Server01 -Count 3 -Delay 2 -MaxHops 255 -BufferSize 256

Test-Connection menggunakan parameter TargetName 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 4: Jalankan pengujian sebagai pekerjaan latar belakang

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

$job = Start-Job -ScriptBlock { Test-Connection -TargetName (Get-Content -Path "Servers.txt") }
$Results = Receive-Job $job -Wait

Perintah Start-Job menggunakan cmdlet Test-Connection untuk melakukan ping pada banyak komputer di perusahaan. Nilai parameter TargetName adalah perintah Get-Content yang membaca daftar nama komputer dari file Servers.txt. Perintah menggunakan cmdlet Start-Job untuk menjalankan perintah sebagai pekerjaan latar belakang dan menyimpan pekerjaan dalam variabel $job.

Perintah Receive-Job diinstruksikan untuk -Wait sampai pekerjaan selesai, lalu mendapatkan hasilnya dan menyimpannya dalam variabel $Results.

Contoh 5: 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 -TargetName Server01 -Quiet) { New-PSSession -ComputerName Server01 }

Cmdlet melakukan ping pada komputer , dengan parameter Diam yang disediakan. Nilai yang dihasilkan $true jika salah satu dari empat ping berhasil. Jika tidak ada ping yang berhasil, nilainya $false.

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

Contoh 6: Gunakan parameter Traceroute

Diperkenalkan di PowerShell 6.0, parameter Traceroute memetakan rute antara komputer lokal dan tujuan jarak jauh yang Anda tentukan dengan parameter TargetName.

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

Perintah Test-Connection dipanggil dengan parameter Traceroute. Hasilnya, yang merupakan objek [Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus], dikeluarkan ke aliran output Success.

Contoh 7: Dapatkan output terperinci untuk pengujian koneksi TCP

Saat Anda menggunakan parameter terperinci , cmdlet ini mengembalikan informasi terperinci tentang status upaya koneksi TCP.

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      Success

Parameter

-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

DefaultPing

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

RepeatPing

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
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

DefaultPing

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

TcpPort

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:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DefaultPing

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

RepeatPing

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

TcpPort

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

-Detailed

Saat Anda menggunakan parameter terperinci , cmdlet ini mengembalikan informasi terperinci tentang status upaya koneksi TCP.

Parameter ini ditambahkan di PowerShell 7.4.

Properti parameter

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

Kumpulan parameter

TcpPort

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

-DontFragment

Parameter ini mengatur bendera Jangan Dipecah di header IP. Anda dapat menggunakan parameter ini dengan parameter BufferSize untuk menguji ukuran MTU lintasan. Untuk informasi selengkapnya tentang Path MTU, lihat artikel Path MTU Discovery di Wikipedia.

Properti parameter

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

Kumpulan parameter

DefaultPing

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

RepeatPing

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

-IPv4

Memaksa cmdlet untuk menggunakan protokol IPv4 untuk pengujian.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-IPv6

Memaksa cmdlet untuk menggunakan protokol IPv6 untuk pengujian.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-MaxHops

Mengatur jumlah maksimum hop yang dapat dikirim oleh pesan permintaan ICMP. Nilai default dikontrol oleh sistem operasi. Nilai default untuk Windows 10 dan yang lebih tinggi adalah 128 lompatan.

Properti parameter

Jenis:	Int32
Nilai default:	128
Mendukung wildcard:	False
DontShow:	False
Alias:	Ttl, TimeToLive, Ragi bir

Kumpulan parameter

DefaultPing

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

RepeatPing

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

TraceRoute

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

-MtuSize

Parameter ini digunakan untuk menemukan ukuran MTU jalur. Cmdlet mengembalikan objek PingReply#MTUSize yang berisi ukuran Path MTU ke target. Untuk informasi selengkapnya tentang Path MTU, lihat artikel Path MTU Discovery di Wikipedia.

Properti parameter

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

Kumpulan parameter

MtuSizeDetect

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

-Ping

Menyebabkan cmdlet melakukan tes ping. Ini adalah mode default untuk cmdlet Test-Connection.

Properti parameter

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

Kumpulan parameter

DefaultPing

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

RepeatPing

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

-Quiet

Parameter Tenang mengembalikan nilai Boolean. Menggunakan parameter ini menekan semua kesalahan.

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

Jika ping ke target tertentu berhasil, $true dikembalikan.

Jika semua ping ke target tertentu gagal, $false dikembalikan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-Repeat

Menyebabkan cmdlet mengirim permintaan ping terus menerus. Ketika nilai TargetName adalah array target, cmdlet mengulangi permintaan ping hanya untuk target pertama. Ini mengabaikan target yang tersisa. Parameter ini tidak dapat digunakan dengan parameter Count.

Properti parameter

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

Kumpulan parameter

RepeatPing

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

TcpPort

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

-ResolveDestination

Menyebabkan cmdlet berusaha memperjelas nama DNS target. Ketika digunakan bersama dengan parameter Traceroute, nama DNS dari semua host perantara juga akan diambil, jika memungkinkan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-Source

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

Nota

Parameter ini tidak didukung di PowerShell versi 6 ke atas. Menyediakan parameter ini menyebabkan kesalahan.

Properti parameter

Jenis:	String
Nilai default:	Local computer
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DefaultPing

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

RepeatPing

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

TraceRoute

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

TcpPort

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

-TargetName

Menentukan komputer yang akan diuji. Ketik nama komputer atau ketik alamat IP dalam format IPv4 atau IPv6.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Nama Komputer

Kumpulan parameter

(All)

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

-TcpPort

Menentukan nomor port TCP pada target yang akan digunakan dalam pengujian koneksi TCP.

Cmdlet mencoba membuat koneksi TCP ke port yang ditentukan pada target.

• Cmdlet mengembalikan $true jika koneksi dibuat.
• Cmdlet mengembalikan $false jika koneksi tidak dibuat.

Properti parameter

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

Kumpulan parameter

TcpPort

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

-TimeoutSeconds

Mengatur nilai batas waktu untuk pengujian. Pengujian gagal jika respons tidak diterima sebelum batas waktu berakhir. Defaultnya adalah lima detik.

Parameter ini diperkenalkan di PowerShell 6.0.

Properti parameter

Jenis:	Int32
Nilai default:	5 seconds
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

-Traceroute

Menyebabkan cmdlet melakukan tes traceroute. Ketika parameter ini digunakan, cmdlet mengembalikan objek TestConnectionCommand+TraceStatus.

Properti parameter

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

Kumpulan parameter

TraceRoute

Position:	Named
Wajib:	True
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

Microsoft.PowerShell.Commands.TestConnectionCommand+PingStatus

Secara default, cmdlet ini mengembalikan objek TestConnectionCommand+PingStatus untuk setiap balasan ping.

Microsoft.PowerShell.Commands.TestConnectionCommand+TraceStatus

Saat Anda menggunakan parameter Traceroute, cmdlet ini mengembalikan objek TestConnectionCommand+TraceStatus untuk setiap balasan ping di sepanjang rute.

Boolean

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

Microsoft.PowerShell.Commands.TestConnectionCommand+PingMtuStatus

Saat Anda menggunakan parameter MtuSize, cmdlet ini mengembalikan objek TestConnectionCommand+PingMtuStatus untuk setiap balasan ping.

Microsoft.PowerShell.Commands.TestConnectionCommand+TcpPortStatus

Saat Anda menggunakan parameter terperinci , cmdlet ini mengembalikan objek TestConnectionCommand+TcpPortStatus yang menunjukkan status koneksi TCP.

Catatan

Di Linux, menggunakan parameter BufferSize atau kombinasi parameter apa pun dengan parameter MtuSize yang menghasilkan ukuran buffer non-default 32 byte mungkin memerlukan . Dalam kasus tersebut, Test-Command menimbulkan pengecualian dengan pesan yang menunjukkan bahwa sudo diperlukan.

Link Terkait

• Mulai Ulang Komputer
• Matikan-Komputer