Mengaktifkan Klien Cerdas (Mode Kernel)

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

Ada dua cara untuk memulai klien pintar: dengan memulai KD atau WinDbg dengan protokol kernel kdsrv, atau dengan menggunakan antarmuka grafis WinDbg.

Anda perlu menentukan protokol transfer jarak jauh yang digunakan oleh server koneksi KD. Anda juga dapat menentukan protokol untuk koneksi kernel aktual antara server koneksi KD dan komputer target, atau Anda dapat menggunakan default.

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.

Sintaks umum untuk memulai klien pintar tergantung pada protokol yang digunakan. Opsi berikut ini ada:

Metode koneksi yang direkomendasikan, dengan beberapa keamanan tambahan

Debugger -k kdsrv:server=@{spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]},trans=@{ConnectType} [Options]

metode koneksi tidak aman

Debugger -k kdsrv:server=@{npipe:server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{tcp:server=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]

Untuk menggunakan antarmuka grafis untuk menyambungkan ke server koneksi KD, 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 koneksi KD aktif.

Parameter dalam perintah sebelumnya memiliki nilai yang mungkin berikut:

Debugger
Ini bisa KD atau WinDbg.

Server
Ini adalah nama jaringan atau alamat IP komputer tempat server koneksi KD 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 koneksi KD 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 -k kdsrv atau dengan menggunakan antarmuka grafis WinDbg.

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

clicon
Menentukan bahwa server koneksi KD 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 koneksi KD 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 koneksi KD dibuat.

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

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

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

kata sandi = Kata Sandi
Jika kata sandi digunakan saat server koneksi KD 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.

trans=@{ConnectType}
Memberi tahu debugger cara menyambungkan ke target. Protokol koneksi kernel berikut diizinkan:

com:port=ComPort,baud=BaudRate 
usb2:targetname=String 
com:pipe,port=\\VMHost\pipe\PipeName[,resets=0][,reconnect]
com:modem 

Untuk informasi tentang protokol ini, lihat Menyiapkan debugging. Anda dapat menghilangkan salah satu parameter untuk protokol ini -- misalnya, Anda dapat mengatakan trans=@{com:} -- dan debugger akan default ke nilai yang ditentukan oleh variabel lingkungan di komputer tempat KdSrv berjalan.

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

Karena server koneksi KD hanya bertindak sebagai gateway untuk klien pintar, opsi tambahan akan sama dengan yang akan Anda gunakan jika Anda memulai debugger kernel di komputer tempat KdSrv berjalan. Pengecualian untuk ini adalah opsi apa pun yang menentukan jalur atau nama file akan diambil sebagai jalur di komputer tempat klien pintar berjalan.