BCDEdit /dbgsettings

Параметр /dbgsettings задает или отображает текущие глобальные параметры отладчика для компьютера. Чтобы включить или отключить отладчик ядра, используйте параметр BCDEdit /debug .

Примечание

Перед установкой параметров BCDEdit может потребоваться отключить или приостановить BitLocker и безопасную загрузку на компьютере.

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

Параметры

NET

Указывает, что целевой компьютер и главный компьютер будут использовать сетевое подключение Ethernet для отладки. При использовании этого параметра также необходимо включить параметры HOSTIP и PORT . На целевом компьютере должен быть сетевой адаптер, поддерживаемый средствами отладки для Windows.

HOSTIP:IP
Для сетевой отладки указывает IP-адрес отладчика узла.

КЛЮЧ:ключ
Для сетевой отладки указывает ключ, с помощью которого шифруется соединение. Разрешено только [0-9] и [a-z]. Не указывайте этот параметр, если вы указали параметр newkey .

PORT:port
Для сетевой отладки указывает порт для обмена данными в отладчике узла. Должно быть 49152 или выше.

newkey
Для сетевой отладки указывает, что для подключения должен быть создан новый ключ шифрования. Не указывайте этот параметр, если вы указали параметр KEY .

nodhcp

Установка параметра nodhcp запрещает использовать DHCP для получения целевого IP-адреса. Этот параметр редко требуется, так как даже небольшие маршрутизаторы обеспечивают поддержку DHCP. Параметр nodhcp следует использовать только в том случае, если известно, что в сети нет DHCP-серверов. В большинстве случаев транспорт KDNET лучше всего работает, если этот параметр не задан и dhcp включен.

busparams=Bus.Device.Function — указывает целевой контроллер. Bus указывает номер шины, Device — номер устройства, а Function — номер функции.

Чтобы указать параметры шины, откройте диспетчер устройств и найдите сетевой адаптер, который требуется использовать для отладки. Откройте страницу свойств сетевого адаптера и запишите номер шины, номер устройства и номер функции. Эти значения отображаются в диспетчер устройств в разделе Расположение на вкладке Общие. В окне командной строки с повышенными привилегиями введите следующую команду, где b, d и f — номера шины, устройства и функции в десятичном формате:

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

При настройке подключения к отладчику вручную необходимо указать параметры шины. Дополнительные сведения см. в разделах Настройка отладки сетевого ядра KDNET вручную и Настройка отладки Kernel-Mode через кабель USB 3.0 вручную.

Примеры

Следующая команда настраивает целевой компьютер для использования ethernet-подключения для отладки и указывает IP-адрес главного компьютера. Команда также указывает номер порта, который главный компьютер может использовать для подключения к целевому компьютеру.

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

Следующая команда задает параметры глобального отладчика для сетевой отладки с помощью протокола IPv6 с узлом отладчика по адресу 2001:48:d8:2f:5e:c0:42:28:4f5b, взаимодействующим через порт 50000:

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

Важно!

Настройка отладки сети вручную — это сложный процесс, подверженный ошибкам. Чтобы настроить автоматическую отладку сети, см. раздел Автоматическая настройка отладки сетевого ядра KDNET. Настоятельно рекомендуется использовать служебную программу KDNET для всех пользователей отладчика.

Дополнительные сведения о настройке вручную см. в разделе Настройка Kernel-Mode Отладка через сетевой кабель вручную.

LOCAL

Параметр LOCAL задает для параметра глобальной отладки локальную отладку. Это отладка в режиме ядра на одном компьютере. Иными словами, отладчик работает на том же компьютере, на котором выполняется отладка. С помощью локальной отладки можно проверить состояние, но не прерывать процессы в режиме ядра, что приведет к остановке работы ОС.

Пример

Следующая команда задает для глобальных параметров отладчика локальную отладку.

bcdedit /dbgsettings LOCAL

Параметр LOCAL доступен в Windows 8.0 и Windows Server 2012 и более поздних версиях.

Сведения о настройке отладки в режиме локального ядра вручную см. в разделе Настройка отладки локального ядра на одном компьютере вручную.

СЕРИЙНЫЙ

Указывает, что целевой компьютер и главный компьютер будут использовать последовательное подключение для отладки. При использовании этого параметра необходимо указать параметры DEBUGPORT и BAUDRATE .

BAUDRATE:baud
Указывает используемую скорость передачи данных. Этот параметр является необязательным. Допустимые значения для baud : 9600, 19200, 38400, 57600 и 115200. Скорость передачи по умолчанию составляет 115200 бит/с.

DEBUGPORT:port
Указывает последовательный порт, используемый в качестве порта отладки. Этот параметр является необязательным. Порт по умолчанию — 1 (COM 1).

Пример

Следующая команда настраивает целевой компьютер для использования последовательного подключения для отладки. Команда также указывает, что подключение отладки будет использовать COM1 и скорость передачи данных 115 200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Дополнительные сведения см. в разделе Настройка отладки Kernel-Mode через последовательный кабель вручную.

USB

Указывает, что целевой компьютер и главный компьютер будут использовать подключение USB 2.0 или USB 3.0 для отладки. При использовании этого параметра также должен быть включен параметр TARGETNAME .

TARGETNAME:targetname
Задает строковое значение, используемое для целевого имени. Обратите внимание, что TargetName не обязательно должно быть официальным именем целевого компьютера. Это может быть любая строка, которую вы создаете, если она соответствует следующим ограничениям:

• Строка не должна содержать слово debug в любом месте TargetName в верхнем или нижнем регистре. Например, если вы используете DeBuG или DEBUG в любом месте целевого имени, отладка будет работать неправильно.
• Единственными символами в строке являются дефис (-), символ подчеркивания(_), цифры от 0 до 9 и буквы A–Z (в верхнем или нижнем регистре).
• Максимальная длина строки составляет 24 символа.

Пример

Следующая команда настраивает целевой компьютер для использования USB-подключения для отладки. Команда также указывает имя целевого объекта, которое главный компьютер может использовать для подключения к целевому компьютеру.

bcdedit /dbgsettings usb targetname:myTarget

Дополнительные сведения см. в разделе:

• Настройка отладки Kernel-Mode через кабель USB 3.0 вручную
• Настройка отладки Kernel-Mode через кабель USB 2.0 вручную

1394

Важно!

Транспорт 1394 доступен для использования в Windows 10 версии 1607 и более ранних версий. Он недоступен в более поздних версиях Windows. Следует перенести проекты на другие транспортные средства, например KDNET с помощью Ethernet. Дополнительные сведения об этом транспорте см. в статье Автоматическая отладка сетевого ядра KDNET.

Указывает, что целевой компьютер и главный компьютер будут использовать подключение IEEE 1394 (FireWire) для отладки. При использовании этого параметра можно также включить параметр CHANNEL .

CHANNEL:channel
(Используется только при типе подключения 1394.) Указывает используемый канал 1394. Значение для канала должно быть десятичным целым числом от 0 до 62 включительно и должно соответствовать номеру канала, используемому главным компьютером. Канал, указанный в этом параметре, не зависит от физического порта 1394, выбранного для адаптера. Значение по умолчанию для канала — 0.

Дополнительные сведения см. в разделе Настройка отладки Kernel-Mode по кабелю 1394 вручную.

Общие параметры отладчика

/startstartpolicy
Этот параметр задает политику запуска отладчика. В следующей таблице показаны параметры для политики startpolicy.

Параметр	Описание
ACTIVE	Указывает, что отладчик ядра активен.
АВТОМАТИЧЕСКОЕ ЗАПОЛНЕНИЕ	Указывает, что отладчик ядра включается автоматически при возникновении исключения или другого критического события. До тех пор отладчик активен, но отключен.
DISABLE	Указывает, что отладчик ядра включается при вводе kdbgctrl для очистки блока включения. До тех пор отладчик активен, но отключен.

Если политика запуска не указана, по умолчанию используется параметр ACTIVE.

/noumex
Указывает, что отладчик ядра игнорирует исключения в пользовательском режиме. По умолчанию отладчик ядра прерывается для определенных исключений пользовательского режима, таких как STATUS_BREAKPOINT и STATUS_SINGLE_STEP. Параметр /noumex действует только в том случае, если к процессу не подключен отладчик пользовательского режима.

Комментарии

Параметр /dbgsettings настраивает параметры отладки, но не включает отладку. Чтобы включить отладку для определенной записи загрузки, необходимо использовать параметр /debug . Если для определенной записи загрузки не указаны параметры отладки, используются параметры отладки по умолчанию.

Значения по умолчанию для dbgsettings показаны в следующей таблице.

параметр dbgsetting	Значение по умолчанию
тип отладки	Local
debugstart	Активен
noumex	Да

См. также

Сведения о средствах отладки Windows см. в разделе Отладка Windows.

Сведения о настройке сеанса отладки в режиме ядра см. в разделах Настройка Kernel-Mode Отладка вручную и Настройка автоматической отладки сетевого ядра KDNET.