Compartir vía

BCDEdit /dbgsettings

  • Artículo

La opción /dbgsettings establece o muestra la configuración actual del depurador global para el equipo. Para habilitar o deshabilitar el depurador de kernel, use la opción BCDEdit /debug .

Nota:

Antes de establecer las opciones bcDEdit, es posible que tenga que deshabilitar o suspender BitLocker y arranque seguro en el equipo.

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

Parámetros

NET

Especifica que la máquina de destino y la máquina host usarán una conexión de red Ethernet para la depuración. Cuando se usa esta opción, también se deben incluir los parámetros HOSTIP y PORT . El equipo de destino debe tener un adaptador de red compatible con herramientas de depuración para Windows.

HOSTIP:ip
Para la depuración de red, especifica la dirección IP del depurador de host.

KEY:key
Para la depuración de red, especifica la clave con la que se va a cifrar la conexión. [0-9] y [a-z] solo se permiten. No especifique este parámetro si ha especificado el parámetro newkey .

PORT:port
Para la depuración de red, especifica el puerto con el que comunicarse en el depurador de host. Debe ser 49152 o superior.

newkey
Para la depuración de red, especifica que se debe generar una nueva clave de cifrado para la conexión. No especifique este parámetro si ha especificado un parámetro KEY .

nodhcp

Establecer nodhcp impide el uso de DHCP para obtener la dirección IP de destino. Esta opción rara vez es necesaria, ya que incluso los enrutadores pequeños proporcionan compatibilidad con DHCP. La opción nodhcp solo debe usarse si sabe que no hay ningún servidor DHCP en la red. En la mayoría de las situaciones, el transporte KDNET funciona mejor cuando no se establece esta opción y DHCP está habilitado.

busparams=Bus.Device.Function Especifica el controlador de destino. Bus especifica el número de bus, Device especifica el número de dispositivo y Function especifica el número de función.

Para especificar los parámetros de bus, Abra Administrador de dispositivos y busque el adaptador de red que desea usar para la depuración. Abra la página de propiedades del adaptador de red y anote el número de bus, el número de dispositivo y el número de función. Estos valores se muestran en Administrador de dispositivos en Ubicación en la pestaña General. En una ventana del símbolo del sistema con privilegios elevados, escriba el siguiente comando, donde b, d y f son los números de bus, dispositivo y función en formato decimal:

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

Si configura manualmente una conexión del depurador, debe especificar los parámetros de bus. Para obtener más información, vea Configurar manualmente la depuración del kernel de red KDNET y configurar la depuración en modo kernel a través de un cable USB 3.0 manualmente.

Ejemplos

El siguiente comando configura el equipo de destino para usar una conexión Ethernet para la depuración y especifica la dirección IP del equipo host. El comando también especifica un número de puerto que el equipo host puede usar para conectarse al equipo de destino.

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

El comando siguiente establece la configuración del depurador global en la depuración de red mediante IPv6 con un host del depurador en 2001:48:d8:2f:5e:c0:42:28:4f5b que se comunica en el puerto 50000:

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

Importante

La configuración manual de una depuración de red es un proceso complejo y propenso a errores. Para configurar la depuración de red automáticamente, consulte Configuración automática de la depuración del kernel de red KDNET. Se recomienda encarecidamente usar la utilidad KDNET para todos los usuarios del depurador.

Para obtener más información sobre la configuración manual, vea Configurar la depuración en modo kernel a través de un cable de red manualmente.

LOCAL

La opción LOCAL establece la opción de depuración global en la depuración local. Esta es la depuración en modo kernel en un solo equipo. En otras palabras, el depurador se ejecuta en el mismo equipo que se está depurando. Con la depuración local, puede examinar el estado, pero no interrumpir los procesos en modo kernel que harían que el sistema operativo dejara de ejecutarse.

Ejemplo

El comando siguiente establece la configuración del depurador global en la depuración local.

bcdedit /dbgsettings LOCAL

La opción LOCAL está disponible en Windows 8.0 y Windows Server 2012 y versiones posteriores.

Para obtener información sobre cómo configurar manualmente la depuración del modo kernel local, vea Configurar la depuración de kernel local de un único equipo manualmente.

SERIAL

Especifica que la máquina de destino y la máquina host usarán una conexión serie para la depuración. Cuando se usa esta opción, se deben especificar los parámetros DEBUGPORT y BAUDRATE .

BAUDRATE:baud
Especifica la velocidad de baudios que se va a usar. Este parámetro es opcional. Los valores válidos para baud son 9600, 19200, 38400, 57600 y 115200. La velocidad de baudios predeterminada es 115200 bps.

DEBUGPORT:port
Especifica el puerto serie que se va a usar como puerto de depuración. Se trata de un parámetro opcional. El puerto predeterminado es 1 (COM 1).

Ejemplo

El siguiente comando configura el equipo de destino para usar una conexión serie para la depuración. El comando también especifica que la conexión de depuración usará COM1 y una velocidad de baudios de 115 200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Para obtener más información, vea Configurar la depuración en modo kernel a través de un cable serie manualmente.

USB

Especifica que la máquina de destino y la máquina host usarán una conexión USB 2.0 o USB 3.0 para la depuración. Cuando se usa esta opción, también se debe incluir el parámetro TARGETNAME .

TARGETNAME: targetname
Especifica un valor de cadena que se va a usar para el nombre de destino. Tenga en cuenta que TargetName no tiene que ser el nombre oficial del equipo de destino; puede ser cualquier cadena que cree siempre que cumpla estas restricciones:

  • La cadena no debe contener "depurar" en ningún lugar de TargetName en cualquier combinación de mayúsculas o minúsculas. Por ejemplo, si usa "DeBuG" o "DEBUG" en cualquier parte del nombre de destino, la depuración no funcionará correctamente.
  • Los únicos caracteres de la cadena son el guión (-), el carácter de subrayado(_), los dígitos del 0 al 9 y las letras A a Z (mayúsculas o minúsculas).
  • La longitud máxima de la cadena es de 24 caracteres.

Ejemplo

El siguiente comando configura el equipo de destino para usar la conexión USB para la depuración. El comando también especifica un nombre de destino que el equipo host puede usar para conectarse al equipo de destino.

bcdedit /dbgsettings usb targetname:myTarget

Para más información, vea:

1394

Importante

El transporte 1394 está disponible para su uso en Windows 10, versión 1607 y versiones anteriores. No está disponible en versiones posteriores de Windows. Debe realizar la transición de los proyectos a otros transportes, como KDNET mediante Ethernet. Para obtener más información sobre ese transporte, vea Configurar la depuración automática del kernel de red KDNET.

Especifica que la máquina de destino y la máquina host usarán una conexión IEEE 1394 (FireWire) para la depuración. Cuando se usa esta opción, también se puede incluir el parámetro CHANNEL .

CHANNEL:channel
(Solo se usa cuando el tipo de conexión es 1394). Especifica el canal 1394 que se va a usar. El valor del canal debe ser un entero decimal entre 0 y 62, ambos incluidos, y debe coincidir con el número de canal usado por el equipo host. El canal especificado en este parámetro no depende del puerto físico 1394 elegido en el adaptador. El valor predeterminado del canal es 0.

Para obtener más información, vea Configurar la depuración en modo kernel a través de un cable de 1394 manualmente.

Configuración general del depurador

/start startpolicy
Esta opción especifica la directiva de inicio del depurador. En la tabla siguiente se muestran las opciones de startpolicy.

Opción Descripción
ACTIVO Especifica que el depurador de kernel está activo.
AUTOENABLE Especifica que el depurador de kernel se habilita automáticamente cuando se produce una excepción u otro evento crítico. Hasta entonces, el depurador está activo, pero está deshabilitado.
DISABLE Especifica que el depurador de kernel está habilitado al escribir kdbgctrl para borrar el bloque enable. Hasta entonces, el depurador está activo, pero está deshabilitado.

Si no se especifica una directiva de inicio, ACTIVE es el valor predeterminado.

/noumex
Especifica que el depurador de kernel omite las excepciones en modo de usuario. De forma predeterminada, el depurador de kernel se interrumpe para determinadas excepciones en modo de usuario, como STATUS_BREAKPOINT y STATUS_SINGLE_STEP. El parámetro /noumex solo es efectivo cuando no hay ningún depurador en modo de usuario asociado al proceso.

Comentarios

La opción /dbgsettings configura las opciones de depuración, pero no habilita la depuración. Debe usar la opción /debug para habilitar la depuración para una entrada de arranque específica. Si no hay ninguna configuración de depuración especificada para una entrada de arranque determinada, se usa la configuración de depuración predeterminada.

Los valores predeterminados de dbgsettings se muestran en la tabla siguiente.

parámetro dbgsetting Valor predeterminado
debugtype Local
debugstart Activas
noumex Sí

Consulte también

Para obtener información sobre las herramientas de depuración de Windows, consulte Depuración de Windows.

Para obtener información sobre cómo configurar y configurar una sesión de depuración en modo kernel, vea Configurar manualmente la depuración en modo kernel y configurar la depuración automática del kernel de red KDNET.