Bagikan melalui

BCDEdit /dbgsettings

  • Artikel

Opsi /dbgsettings mengatur atau menampilkan pengaturan debugger global saat ini untuk komputer. Untuk mengaktifkan atau menonaktifkan debugger kernel, gunakan opsi BCDEdit /debug .

Catatan

Sebelum mengatur opsi BCDEdit, Anda mungkin perlu menonaktifkan atau menangguhkan BitLocker dan Boot Aman di komputer.

bcdedit /dbgsettings NET HOSTIP:ip PORT:port [KEY:key] [nodhcp] [newkey] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings LOCAL [/start startpolicy] [/noumex] 

bcdedit /dbgsettings SERIAL [DEBUGPORT:port] [BAUDRATE:baud] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings USB [TARGETNAME:targetname] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings 1394 [CHANNEL:channel] [/start startpolicy] [/noumex] NOTE: The 1394 TRANSPORT IS DEPRECATED

Parameter

NET

Menentukan bahwa komputer target dan komputer host akan menggunakan koneksi jaringan Ethernet untuk penelusuran kesalahan. Ketika opsi ini digunakan, parameter HOSTIP dan PORT juga harus disertakan. Komputer target harus memiliki adaptor jaringan yang didukung oleh Alat Debugging untuk Windows.

HOSTIP:ip
Untuk penelusuran kesalahan jaringan, menentukan alamat IP debugger host.

KEY:key
Untuk penelusuran kesalahan jaringan, menentukan kunci untuk mengenkripsi koneksi. [0-9] dan [a-z] hanya diperbolehkan. Jangan tentukan parameter ini jika Anda telah menentukan parameter newkey .

PORT:port
Untuk penelusuran kesalahan jaringan, menentukan port untuk berkomunikasi dengan pada debugger host. Harus 49152 atau lebih tinggi.

newkey
Untuk penelusuran kesalahan jaringan menentukan bahwa kunci enkripsi baru harus dibuat untuk koneksi. Jangan tentukan parameter ini jika Anda telah menentukan parameter KEY .

nodhcp

Mengatur nodhcp mencegah penggunaan DHCP untuk mendapatkan alamat IP target. Opsi ini jarang diperlukan karena bahkan router kecil memberikan dukungan untuk DHCP. Opsi nodhcp hanya boleh digunakan jika Anda tahu bahwa tidak ada server DHCP di jaringan. Dalam kebanyakan situasi, transportasi KDNET berfungsi paling baik ketika opsi ini tidak diatur, dan DHCP diaktifkan.

busparams=Bus.Device.Function Menentukan pengontrol target. Bus menentukan nomor bus, Perangkat menentukan nomor perangkat, dan Fungsi menentukan nomor fungsi.

Untuk menentukan parameter bus, Buka Device Manager, dan temukan adaptor jaringan yang ingin Anda gunakan untuk penelusuran kesalahan. Buka halaman properti untuk adaptor jaringan, dan catat nomor bus, nomor perangkat, dan nomor fungsi. Nilai-nilai ini ditampilkan di Manajer Perangkat di bawah Lokasi pada tab Umum . Di Jendela Prompt Perintah yang ditingkatkan, masukkan perintah berikut, di mana b, d, dan f adalah nomor bus, perangkat, dan fungsi dalam format desimal:

bcdedit /set "{dbgsettings}" busparams b.d.f

Jika Anda mengonfigurasi koneksi debugger secara manual, Anda harus menentukan parameter bus. Untuk informasi selengkapnya, lihat Menyiapkan Debugging Kernel Jaringan KDNET Secara Manual dan Menyiapkan Debugging Mode Kernel melalui Kabel USB 3.0 Secara Manual.

Contoh

Perintah berikut mengonfigurasi komputer target untuk menggunakan koneksi Ethernet untuk penelusuran kesalahan dan menentukan alamat IP komputer host. Perintah ini juga menentukan nomor port yang dapat digunakan komputer host untuk menyambungkan ke komputer target.

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

Perintah berikut mengatur pengaturan debugger global ke penelusuran kesalahan jaringan menggunakan IPv6 dengan host debugger pada 2001:48:d8:2f:5e:c0:42:28:4f5b berkomunikasi pada port 50000:

bcdedit /dbgsettings NET HOSTIPV6:2001:48:d8:2f:5e:c0:42:28:4f5b PORT:50000

Penting

Menyiapkan penelusuran kesalahan jaringan secara manual adalah proses yang kompleks dan rawan kesalahan. Untuk menyiapkan penelusuran kesalahan jaringan secara otomatis, lihat Menyiapkan Penelusuran Kesalahan Kernel Jaringan KDNET Secara Otomatis. Menggunakan utilitas KDNET sangat disarankan untuk semua pengguna debugger.

Untuk informasi selengkapnya tentang penyiapan manual, lihat Menyiapkan Debugging Mode Kernel melalui Kabel Jaringan Secara Manual.

LOKAL

Opsi LOCAL mengatur opsi penelusuran kesalahan global ke penelusuran kesalahan lokal. Ini adalah penelusuran kesalahan mode kernel pada satu komputer. Dengan kata lain, debugger berjalan pada komputer yang sama yang sedang di-debug. Dengan penelusuran kesalahan lokal, Anda dapat memeriksa status, tetapi tidak masuk ke dalam proses mode kernel yang akan menyebabkan OS berhenti berjalan.

Contoh

Perintah berikut mengatur pengaturan debugger global ke penelusuran kesalahan lokal.

bcdedit /dbgsettings LOCAL

Opsi LOCAL tersedia di Windows 8.0 dan Windows Server 2012 dan yang lebih baru.

Untuk informasi tentang menyiapkan penelusuran kesalahan mode kernel lokal secara manual, lihat Menyiapkan Penelusuran Kesalahan Kernel Lokal Komputer Tunggal Secara Manual.

SERIAL

Menentukan bahwa komputer target dan komputer host akan menggunakan koneksi serial untuk penelusuran kesalahan. Ketika opsi ini digunakan, parameter DEBUGPORT dan BAUDRATE harus ditentukan.

BAUDRATE:baud
Menentukan laju baud yang akan digunakan. Parameter ini bersifat opsional. Nilai yang valid untuk baud adalah 9600, 19200, 38400, 57600, dan 115200. Tingkat baud default adalah 115200 bps.

DEBUGPORT:port
Menentukan port serial yang akan digunakan sebagai port penelusuran kesalahan. Ini adalah pengaturan opsional. Port default adalah 1 (COM 1).

Contoh

Perintah berikut mengonfigurasi komputer target untuk menggunakan koneksi serial untuk penelusuran kesalahan. Perintah ini juga menentukan bahwa koneksi penelusuran kesalahan akan menggunakan COM1 dan tingkat baud 115.200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Untuk informasi selengkapnya, lihat Menyiapkan Debugging Mode Kernel melalui Kabel Serial Secara Manual.

USB

Menentukan bahwa komputer target dan komputer host akan menggunakan koneksi USB 2.0 atau USB 3.0 untuk penelusuran kesalahan. Ketika opsi ini digunakan, parameter TARGETNAME juga harus disertakan.

TARGETNAME: nama target
Menentukan nilai string yang akan digunakan untuk nama target. Perhatikan bahwa TargetName tidak harus menjadi nama resmi komputer target; dapat berupa string apa pun yang Anda buat selama memenuhi batasan ini:

  • String tidak boleh berisi "debug" di mana pun di TargetName dalam kombinasi huruf besar atau kecil apa pun. Misalnya jika Anda menggunakan "DeBuG" atau "DEBUG" di mana saja di nama target Anda, penelusuran kesalahan tidak akan berfungsi dengan benar.
  • Satu-satunya karakter dalam string adalah tanda hubung (-), garis bawah(_), digit 0 hingga 9, dan huruf A hingga Z (huruf besar atau kecil).
  • Panjang maksimum string adalah 24 karakter.

Contoh

Perintah berikut mengonfigurasi komputer target untuk menggunakan koneksi USB untuk penelusuran kesalahan. Perintah ini juga menentukan nama target yang dapat digunakan komputer host untuk menyambungkan ke komputer target.

bcdedit /dbgsettings usb targetname:myTarget

Untuk informasi selengkapnya, lihat:

1394

Penting

Transportasi 1394 tersedia untuk digunakan di Windows 10, versi 1607 dan yang lebih lama. Ini tidak tersedia di versi Windows yang lebih baru. Anda harus transisi proyek Anda ke transportasi lain, seperti KDNET menggunakan Ethernet. Untuk informasi selengkapnya tentang transportasi tersebut, lihat Menyiapkan Penelusuran Kesalahan Kernel Jaringan KDNET Secara Otomatis.

Menentukan bahwa komputer target dan komputer host akan menggunakan koneksi IEEE 1394 (FireWire) untuk penelusuran kesalahan. Ketika opsi ini digunakan, parameter CHANNEL juga dapat disertakan.

CHANNEL:channel
(Hanya digunakan saat jenis koneksi adalah 1394.) Menentukan saluran 1394 yang akan digunakan. Nilai untuk saluran harus berupa bilangan bulat desimal antara 0 dan 62, inklusif, dan harus cocok dengan nomor saluran yang digunakan oleh komputer host. Saluran yang ditentukan dalam parameter ini tidak bergantung pada port 1394 fisik yang dipilih pada adaptor. Nilai default untuk saluran adalah 0.

Untuk informasi selengkapnya, lihat Menyiapkan Debugging Mode Kernel melalui Kabel 1394 Secara Manual.

Pengaturan Debugger Umum

/start startpolicy
Opsi ini menentukan kebijakan mulai debugger. Tabel berikut ini memperlihatkan opsi untuk startpolicy.

Opsi Deskripsi
AKTIF Menentukan bahwa debugger kernel aktif.
DAPAT DIOTOMATISKAN Menentukan bahwa debugger kernel diaktifkan secara otomatis saat pengecualian atau peristiwa penting lainnya terjadi. Sampai saat itu, debugger aktif tetapi dinonaktifkan.
MENONAKTIFKAN Menentukan bahwa debugger kernel diaktifkan saat Anda mengetik kdbgctrl untuk menghapus blok pengaktifan. Sampai saat itu, debugger aktif tetapi dinonaktifkan.

Jika kebijakan mulai tidak ditentukan, ACTIVE adalah default.

/noumex
Menentukan bahwa debugger kernel mengabaikan pengecualian mode pengguna. Secara default, debugger kernel berhenti untuk pengecualian mode pengguna tertentu, seperti STATUS_BREAKPOINT dan STATUS_SINGLE_STEP. Parameter /noumex hanya efektif ketika tidak ada debugger mode pengguna yang melekat pada proses.

Komentar

Opsi /dbgsettings mengonfigurasi pengaturan penelusuran kesalahan, tetapi tidak mengaktifkan penelusuran kesalahan. Anda harus menggunakan opsi /debug untuk mengaktifkan penelusuran kesalahan untuk entri boot tertentu. Jika tidak ada pengaturan penelusuran kesalahan yang ditentukan untuk entri boot tertentu, pengaturan debug default akan digunakan.

Nilai default untuk dbgsettings diperlihatkan dalam tabel berikut.

parameter dbgsetting Nilai default
debugtype Lokal
debugstart Aktif
noumex Ya

Lihat juga

Untuk informasi tentang alat penelusuran kesalahan Windows, lihat Penelusuran Kesalahan Windows.

Untuk informasi tentang menyiapkan dan mengonfigurasi sesi debugging mode kernel, lihat Menyiapkan Debugging Mode Kernel Secara Manual dan Menyiapkan Debugging Kernel Jaringan KDNET Secara Otomatis.