Bagikan melalui

Mengaktifkan Server Debugging

Ada dua cara untuk mengaktifkan server penelusuran kesalahan. Ini dapat diaktifkan ketika debugger dimulai dengan menggunakan opsi -server baris perintah di jendela Prompt Perintah yang ditinggikan (Jalankan sebagai Administrator). Ini juga dapat diaktifkan setelah debugger berjalan. Mulai debugger dengan hak istimewa yang ditinggikan (Jalankan sebagai Administrator), dan masukkan perintah .server .

Catatan Anda dapat mengaktifkan server penelusuran kesalahan tanpa memiliki hak istimewa yang ditingkatkan, dan klien penelusuran kesalahan akan dapat terhubung ke server. Namun, klien tidak akan dapat menemukan server debugging kecuali diaktifkan dengan hak istimewa yang ditingkatkan. Untuk informasi tentang cara menemukan server penelusuran kesalahan, lihat Mencari Server Debugging.

Penting

Ada pertimbangan keamanan penting tambahan saat menggunakan penelusuran kesalahan jarak jauh, untuk informasi selengkapnya, termasuk informasi tentang mengaktifkan mode aman, lihat Keamanan Selama Penelusuran Kesalahan Jarak Jauh dan Pertimbangan Keamanan untuk Alat Debugging Windows.

Debugger mendukung beberapa protokol transportasi: bernama pipe (NPIPE), TCP, COM port, secure pipe (SPIPE), dan secure sockets layer (SSL).

Sintaks umum untuk mengaktifkan server penelusuran kesalahan tergantung pada protokol yang digunakan.

Metode koneksi yang direkomendasikan, dengan beberapa keamanan tambahan

Debugger -server spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password] [-noio] [Options]

Debugger -server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password] [-noio] [Options]

Debugger -server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password] [-noio] [Options]

metode koneksi tidak aman

Debugger -server npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] [-noio] [Options]

Debugger -server tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable] [-noio] [Options]

Debugger -server tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6] [-noio] [Options]

Debugger -server com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password] [-noio] [Options]

Metode lain untuk mengaktifkan server penelusuran kesalahan adalah menggunakan perintah .server (Buat Server Debugging) setelah debugger dimulai.

Metode koneksi yang direkomendasikan, dengan beberapa keamanan tambahan

.server spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password] 

.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password] 

.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password]

metode koneksi tidak aman

.server npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] 

.server tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable] 

.server tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6] 

.server com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password]

Parameter

Parameter dalam perintah sebelumnya memiliki nilai yang mungkin berikut:

Debugger
Dapat berupa KD, CDB, NTSD, atau WinDbg.

pipe=PipeName
Ketika protokol NPIPE atau SPIPE digunakan, PipeName adalah string yang akan berfungsi sebagai nama pipa. Setiap nama pipa harus mengidentifikasi server debugging unik. Jika Anda mencoba menggunakan kembali nama pipa, Anda akan menerima pesan kesalahan. PipeName tidak boleh berisi spasi atau tanda kutip. PipeName dapat menyertakan kode formatcetak numerik, seperti %x atau %d. Debugger akan mengganti ini dengan ID proses debugger. Kode kedua tersebut akan diganti dengan ID utas debugger.

Catatan Anda mungkin perlu mengaktifkan berbagi file dan printer pada komputer yang menjalankan server penelusuran kesalahan. Di Panel Kontrol, navigasikan ke Jaringan dan Jaringan > Internet dan Pusat Berbagi> Pengaturan berbagi tingkat lanjut. Pilih Aktifkan berbagi file dan printer.

port = Soket
Ketika protokol TCP atau SSL digunakan, Soket adalah nomor port soket.

Dimungkinkan juga untuk menentukan berbagai port yang dipisahkan oleh titik dua. Debugger akan memeriksa setiap port dalam rentang ini untuk melihat apakah itu gratis. Jika menemukan port gratis dan tidak ada kesalahan yang terjadi, server debugging akan dibuat. Klien penelusuran kesalahan harus menentukan port aktual yang digunakan untuk menyambungkan ke server. Untuk menentukan port aktual, gunakan salah satu metode yang dijelaskan dalam Mencari Server Debugging; ketika server penelusuran kesalahan ini ditampilkan, port akan diikuti oleh dua angka yang dipisahkan oleh titik dua. Angka pertama akan menjadi port aktual yang digunakan; yang kedua dapat diabaikan. Misalnya, jika port ditentukan sebagai port =51:60, dan port 53 benar-benar digunakan, hasil pencarian akan menampilkan "port=53:60". (Jika Anda menggunakan parameter clicon untuk membuat koneksi terbalik, klien penelusuran kesalahan dapat menentukan rentang port dengan cara ini, sementara server harus menentukan port aktual yang digunakan.)

clicon= Klien
Ketika protokol TCP atau SSL digunakan dan parameter clicon ditentukan, koneksi terbalik akan dibuka. Ini berarti bahwa server penelusuran kesalahan akan mencoba terhubung ke klien penelusuran kesalahan, alih-alih membiarkan klien memulai kontak. Ini dapat berguna jika Anda memiliki firewall yang mencegah koneksi ke arah yang biasa. Klien menentukan nama jaringan atau alamat IP komputer tempat klien penelusuran kesalahan ada atau akan dibuat. Dua garis miring terbelakang awal (\) bersifat opsional.

Karena server mencari satu klien tertentu, Anda tidak dapat menghubungkan beberapa klien ke server jika Anda menggunakan metode ini. Jika koneksi ditolak atau rusak, Anda harus memulai ulang koneksi server. Server koneksi terbalik tidak akan muncul ketika debugger lain menampilkan semua server aktif.

Catatan Ketika clicon digunakan, yang terbaik adalah memulai klien debugging sebelum server debugging dibuat, meskipun urutan biasa (server sebelum klien) juga diizinkan.

port = COMPort
Ketika protokol COM digunakan, COMPort menentukan port COM yang akan digunakan. Awalan "COM" bersifat opsional -- misalnya, "com2" dan "2" dapat diterima.

baud=BaudRate
Ketika protokol COM digunakan, BaudRate menentukan laju baud tempat koneksi akan berjalan. Laju baud apa pun yang didukung oleh perangkat keras diizinkan.

channel= COMChannel
Jika protokol COM digunakan, COMChannel menentukan saluran COM yang akan digunakan dalam berkomunikasi dengan klien debugging. Ini bisa menjadi nilai apa pun antara 0 dan 254, inklusif. Anda dapat menggunakan satu port COM untuk beberapa koneksi menggunakan nomor saluran yang berbeda. (Ini berbeda dari penggunaan port COM untuk kabel debug -- dalam situasi tersebut Anda tidak dapat menggunakan saluran dalam port COM.)

proto= Protokol
Jika protokol SSL atau SPIPE digunakan, Protocol menentukan protokol Secure Channel (S-Channel). Ini bisa menjadi salah satu string tls1, pct1, ssl2, atau ssl3.

Cert
Jika protokol SSL atau SPIPE digunakan, Cert menentukan sertifikat. Ini bisa berupa nama sertifikat atau thumbprint sertifikat (string digit heksadesimal yang diberikan oleh snapin sertifikat). Jika sintaks certuser=Cert digunakan, debugger akan mencari sertifikat di penyimpanan sistem (penyimpanan default). Jika sintaks machuser=Cert digunakan, debugger akan mencari sertifikat di penyimpanan komputer. Sertifikat yang ditentukan harus mendukung autentikasi server.

tersembunyi
Mencegah server muncul ketika debugger lain menampilkan semua server aktif.

kata sandi = Kata Sandi
Mengharuskan klien untuk menyediakan kata sandi yang ditentukan untuk terhubung ke sesi penelusuran kesalahan. Password dapat berupa string alfanumerik apa pun, panjangnya hingga dua belas karakter.

Penting

Menggunakan kata sandi dengan protokol TCP, NPIPE, atau COM hanya menawarkan sedikit perlindungan, karena kata sandi tidak dienkripsi. Saat Anda menggunakan kata sandi bersama dengan protokol SSL atau SPIPE, kata sandi dienkripsi. Jika Anda ingin membuat sesi jarak jauh yang lebih aman, Anda harus menggunakan protokol SSL atau SPIPE.

ipversion=6
(Alat Debugging untuk Windows 6.6.07 dan yang lebih lama saja) Memaksa debugger untuk menggunakan IP versi 6 daripada versi 4 saat menggunakan TCP untuk terhubung ke Internet. Di Windows Vista dan versi yang lebih baru, debugger mencoba default otomatis ke IP versi 6, membuat opsi ini tidak perlu.

-noio
Jika server debugging dibuat dengan opsi -noio, tidak ada input atau output yang dapat dilakukan melalui server itu sendiri. Debugger hanya akan menerima input dari klien debugging (ditambah perintah awal atau skrip perintah yang ditentukan oleh opsi baris perintah -c). Semua output akan diarahkan ke klien debugging. Opsi -noio hanya tersedia dengan KD, CDB, dan NTSD. Jika NTSD digunakan untuk server, tidak ada jendela konsol yang akan dibuat sama sekali.

IcfEnable
Menyebabkan debugger mengaktifkan koneksi port yang diperlukan untuk TCP atau komunikasi pipa bernama saat Firewall Koneksi Internet aktif. Secara default, Firewall Koneksi Internet menonaktifkan port yang digunakan oleh protokol ini. Ketika IcfEnable digunakan dengan koneksi TCP, debugger menyebabkan Windows membuka port yang ditentukan oleh parameter Soket . Ketika IcfEnable digunakan dengan koneksi pipa bernama, debugger menyebabkan Windows membuka port yang digunakan untuk pipa bernama (port 139 dan 445). Debugger tidak menutup port ini setelah koneksi berakhir.

Opsi
Parameter baris perintah tambahan dapat ditempatkan di sini. Lihat Opsi Command-Line untuk daftar lengkapnya.

Anda dapat menggunakan perintah .server untuk memulai beberapa server menggunakan opsi protokol yang berbeda. Ini memungkinkan berbagai jenis klien debugging untuk bergabung dengan sesi.

Lihat Juga

Mengontrol Sesi Penelusuran Kesalahan Jarak Jauh

.endsrv (End Debugging Server)