Mengaktifkan Klien Cerdas

Setelah server proses DbgSrv diaktifkan, Anda dapat membuat klien pintar di komputer lain dan memulai sesi penelusuran kesalahan.

Ada dua cara untuk memulai klien pintar: dengan memulai CDB atau WinDbg dengan opsi baris perintah -premote , atau dengan menggunakan antarmuka grafis WinDbg.

Penting

Ada pertimbangan keamanan penting 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 Penelusuran Kesalahan Windows.

Protokol klien pintar harus sesuai dengan protokol server proses. Sintaks umum untuk memulai klien pintar tergantung pada protokol yang digunakan. Opsi berikut ini ada:

Metode koneksi yang direkomendasikan, dengan beberapa keamanan tambahan

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

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

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

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

metode koneksi tidak aman

Debugger -premote npipe:server=Server,pipe=PipeName[,password=Password] [Options]

Debugger -premote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] [Options]

Debugger -premote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] [Options]

Untuk menggunakan antarmuka grafis untuk menyambungkan ke server proses, WinDbg harus dalam mode tidak aktif -- harus dimulai tanpa parameter baris perintah, atau harus mengakhiri sesi debugging sebelumnya. Pilih File | Sambungkan ke perintah menu Stub Jarak Jauh. Saat kotak dialog Sambungkan ke Server Stub Jarak Jauh muncul, masukkan salah satu string berikut ke dalam kotak teks string Koneksi :

Metode koneksi yang direkomendasikan, dengan beberapa keamanan tambahan

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

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

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

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

metode koneksi tidak aman

npipe:server=Server,pipe=PipeName[,password=Password] 

tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

Atau, Anda dapat menggunakan tombol Telusuri untuk menemukan server proses aktif.

Parameter

Parameter dalam perintah sebelumnya memiliki nilai yang mungkin berikut:

Debugger
Ini bisa CDB atau WinDbg.

Server
Ini adalah nama jaringan atau alamat IP komputer tempat server proses dibuat. Dua garis miring terbalik awal (\) bersifat opsional pada baris perintah, tetapi tidak diizinkan dalam kotak dialog WinDbg.

pipe=PipeName
Jika protokol NPIPE atau SPIPE digunakan, PipeName adalah nama yang diberikan ke pipa saat server proses dibuat.

Jika Anda tidak masuk ke komputer klien dengan akun yang memiliki akses ke komputer server, Anda harus memberikan nama pengguna dan kata sandi. Di komputer klien, di jendela Prompt Perintah, masukkan perintah berikut.

net use \\Server\ipc$ /user:UserName

di mana Server adalah nama komputer server, dan UserName adalah nama akun yang memiliki akses ke komputer server.

Ketika Anda diminta, masukkan kata sandi untuk UserName.

Setelah perintah ini berhasil, Anda dapat mengaktifkan klien pintar dengan menggunakan opsi -premote baris perintah atau dengan menggunakan antarmuka grafis WinDbg.

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

port = Soket
Jika protokol TCP atau SSL digunakan, Soket adalah nomor port soket yang sama yang digunakan saat server proses dibuat.

clicon
Menentukan bahwa server proses akan mencoba menyambungkan ke klien pintar melalui koneksi terbalik. Klien harus menggunakan clicon jika dan hanya jika server menggunakan clicon. Dalam kebanyakan kasus, klien pintar dimulai sebelum server proses saat koneksi terbalik digunakan.

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

baud=BaudRate
Jika protokol COM digunakan, BaudRate harus cocok dengan laju baud yang dipilih saat server proses dibuat.

channel= COMChannel
Jika protokol COM digunakan, COMChannel harus cocok dengan nomor saluran yang dipilih saat server proses dibuat.

proto= Protokol
Jika protokol SSL atau SPIPE digunakan, Protokol harus cocok dengan protokol aman yang digunakan saat server proses dibuat.

Cert
Jika protokol SSL atau SPIPE digunakan, Anda harus menggunakan certuser yang identik=Cert atau machuser=cert parameter yang digunakan saat server proses dibuat.

kata sandi = Kata Sandi
Jika kata sandi digunakan saat server proses dibuat, Kata Sandi harus disediakan untuk membuat klien pintar. Ini harus cocok dengan kata sandi asli. Kata sandi peka huruf besar/kecil. Jika kata sandi yang salah disediakan, pesan kesalahan akan menentukan "Kesalahan 0x80004005."

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.

Opsi
Parameter baris perintah tambahan dapat ditempatkan di sini. Lihat Opsi Command-Line untuk daftar lengkapnya. Jika Anda menggunakan CDB, ini harus menentukan proses yang ingin Anda debug. Jika Anda menggunakan WinDbg, Anda dapat menentukan proses pada baris perintah atau melalui antarmuka grafis.

Karena server proses hanya bertindak sebagai gateway untuk klien pintar, opsi tambahan akan sama dengan yang akan Anda gunakan jika Anda memulai debugger mode pengguna pada komputer yang sama dengan aplikasi target.

Jika Anda menggunakan opsi -premote dengan .attach (Lampirkan ke Proses) atau .create (Create Process), parameternya sama dengan yang tercantum di atas.

Pemecahan masalah

Jika Anda melihat pesan ini: Klien tidak menggunakan versi protokol jarak jauh yang sama dengan server ini menunjukkan bahwa versi DbgSrv yang Anda coba sambungkan menggunakan versi protokol yang berbeda dari versi WinDbg.

Tidak jarang perubahan protokol dilakukan. Ketika ini terjadi, pastikan Anda menggunakan versi pencocokan dari versi terbaru DbgSrv dan WinDbg (Klasik) atau WinDbg. Untuk informasi tentang mengunduh versi terbaru, lihat Alat Penelusuran Kesalahan untuk Windows.