.server (Buat Server Debugging)

Perintah .server memulai server penelusuran kesalahan, memungkinkan koneksi jarak jauh ke sesi penelusuran kesalahan saat ini.

Penting

Ada pertimbangan keamanan penting saat menggunakan penelusuran kesalahan jarak jauh. Untuk informasi selengkapnya, termasuk informasi tentang mengaktifkan mode aman, lihat Pertimbangan Keamanan untuk Windows Debugging Tools.

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

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.

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. Client menentukan nama jaringan komputer tempat klien debugging ada atau akan dibuat. Dua garis miring terbelakang awal (\\) bersifat opsional.

Ketika clicon digunakan, yang terbaik adalah memulai klien debugging sebelum server debugging dibuat, meskipun urutan biasa (server sebelum klien) juga diizinkan. Server koneksi terbalik tidak akan muncul ketika debugger lain menampilkan semua server aktif.

COMPort
Ketika protokol COM digunakan, COMPort menentukan port COM yang akan digunakan. COM awalan bersifat opsional (misalnya, "com2" dan "2" dapat diterima).

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

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.

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
Memerlukan klien penelusuran kesalahan untuk menyediakan kata sandi yang ditentukan untuk menyambungkan ke sesi penelusuran kesalahan. Password dapat berupa string alfanumerik apa pun, panjangnya hingga dua belas karakter.

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.

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.

Lingkungan

Benda	Deskripsi
Mode	Mode pengguna, mode kernel
Target	Live, crash dump
Platform	Semua

Informasi Tambahan

Untuk detail lengkap tentang cara memulai server penelusuran kesalahan, lihat Mengaktifkan Server Debugging. Misalnya, lihat Contoh Klien dan Server.

Komentar

Perintah ini mengubah debugger saat ini menjadi server debugging. Ini memungkinkan Anda untuk memulai server setelah debugger sudah berjalan, sedangkan opsi baris perintah -server hanya dapat dikeluarkan ketika debugger dimulai.

Ini memungkinkan klien penelusuran kesalahan untuk terhubung ke sesi penelusuran kesalahan saat ini. Perhatikan bahwa dimungkinkan untuk memulai beberapa server menggunakan opsi yang berbeda, memungkinkan berbagai jenis klien debugging untuk bergabung dengan sesi.

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 aman, Anda harus menggunakan protokol SSL atau SPIPE.