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-адрес отладчика узла.

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

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

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

nodhcp

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

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

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

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

Если вы настраиваете подключение отладчика вручную, необходимо указать параметры шины. Дополнительные сведения см. в статье Настройка отладки сетевого ядра KDNET вручную и настройка отладки режима ядра по кабелю 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 настоятельно рекомендуется для всех пользователей отладчика.

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

Сведения об эмуляции Ethernet по USB см. в разделе Настройка отладки режима ядра по USB EEM с помощью KDNET

ЛОКАЛЬНО

Параметр 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

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

USB

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

TARGETNAME: целевое имя
Указывает строковое значение, используемое для целевого имени. Обратите внимание, что TargetName не обязательно должно быть официальным именем целевого компьютера; Она может быть любой строкой, создаваемой до тех пор, пока она соответствует этим ограничениям:

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

Пример

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

bcdedit /dbgsettings usb targetname:myTarget

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

• Настройка отладки в режиме ядра по кабелю USB 3.0 вручную

1394

Внимание

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

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

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

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

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

Вариант	Описание
АКТИВНЫЕ	Указывает, что отладчик ядра активен.
AUTOENABLE	Указывает, что отладчик ядра включен автоматически при возникновении исключения или другого критического события. До этого отладчик активен, но отключен.
DISABLE	Указывает, что отладчик ядра включен при вводе kdbgctrl для очистки блока включения. До этого отладчик активен, но отключен.

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

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

Комментарии

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

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

параметр dbgsetting	Default value
отладочный тип	Local
отладка	Активно
noumex	Да

См. также

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

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