Partilhar via

BCDEdit /dbgsettings

  • Artigo

A opção /dbgsettings define ou exibe as configurações globais atuais do depurador para o computador. Para habilitar ou desabilitar o depurador de kernel, use a opção BCDEdit /debug .

Observação

Antes de definir as opções do BCDEdit, talvez seja necessário desabilitar ou suspender o BitLocker e a Inicialização Segura no computador.

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 o computador de destino e o computador host usarão uma conexão de rede Ethernet para depuração. Quando essa opção é usada, os parâmetros HOSTIP e PORT também devem ser incluídos. O computador de destino deve ter um adaptador de rede compatível com as Ferramentas de Depuração para Windows.

HOSTIP:ip
Para depuração de rede, especifica o endereço IP do depurador de host.

CHAVE:chave
Para depuração de rede, especifica a chave com a qual criptografar a conexão. [0-9] e [a-z] permitidos apenas. Não especifique esse parâmetro se você tiver especificado o parâmetro newkey .

PORTO: porto
Para depuração de rede, especifica a porta com a qual se comunicar no depurador de host. Deve ser 49152 ou superior.

Chave nova
Para depuração de rede, especifica que uma nova chave de criptografia deve ser gerada para a conexão. Não especifique esse parâmetro se você tiver especificado um parâmetro KEY .

não

A configuração nodhcp impede o uso de DHCP para obter o endereço IP de destino. Essa opção raramente é necessária, pois até mesmo roteadores pequenos fornecem suporte para DHCP. A opção nodhcp só deve ser usada se você souber que não há servidores DHCP na rede. Na maioria das situações, o transporte KDNET funciona melhor quando essa opção não está definida e o DHCP está habilitado.

busparams=Bus.Device.Function Especifica o controlador de destino. Bus especifica o número do barramento, Device especifica o número do dispositivo e Function especifica o número da função.

Para especificar os parâmetros de barramento, abra o Gerenciador de Dispositivos e localize o adaptador de rede que você deseja usar para depuração. Abra a página de propriedades do adaptador de rede e anote o número do barramento, o número do dispositivo e o número da função. Esses valores são exibidos no Gerenciador de Dispositivos em Local na guia Geral . Em uma janela de prompt de comando com privilégios elevados, insira o seguinte comando, em que b, d e f são os números de barramento, dispositivo e função em formato decimal:

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

Se você estiver configurando manualmente uma conexão do depurador, deverá especificar os parâmetros de barramento. Para obter mais informações, consulte Configurando a depuração de kernel de rede KDNET manualmente e Configurando a depuração no modo kernel em um cabo USB 3.0 manualmente.

Exemplos

O comando a seguir configura o computador de destino para usar uma conexão Ethernet para depuração e especifica o endereço IP do computador host. O comando também especifica um número de porta que o computador host pode usar para se conectar ao computador de destino.

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

O comando a seguir define as configurações globais do depurador para depuração de rede usando IPv6 com um host do depurador em 2001:48:d8:2f:5e:c0:42:28:4f5b comunicando-se na porta 50000:

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

Importante

Configurar uma depuração de rede manualmente é um processo complexo e propenso a erros. Para configurar a depuração de rede automaticamente, confira Configurar a depuração automática do kernel de rede KDNET. O uso do utilitário KDNET é altamente recomendado para todos os usuários do depurador.

Para obter mais informações sobre a configuração manual, consulte Configurando a depuração do modo kernel em um cabo de rede manualmente.

LOCAL

A opção LOCAL define a opção de depuração global como depuração local. Isso significa a depuração no modo kernel em um único computador. Em outras palavras, o depurador é executado no mesmo computador que está sendo depurado. Com a depuração local, você pode examinar o estado, mas não interromper os processos do modo kernel que fariam com que o sistema operacional parasse de ser executado.

Exemplo

O comando a seguir define as configurações globais do depurador para depuração local.

bcdedit /dbgsettings LOCAL

A opção LOCAL está disponível no Windows 8.0 e no Windows Server 2012 e posterior.

Para obter informações sobre como configurar a depuração do modo kernel local manualmente, consulte Configurando a depuração do kernel local de um único computador manualmente.

SERIAL

Especifica que o computador de destino e o computador host usarão uma conexão serial para depuração. Quando essa opção é usada, os parâmetros DEBUGPORT e BAUDRATE devem ser especificados.

TAXA DE TRANSMISSÃO: baud
Especifica a taxa de transmissão a ser usada. Esse parâmetro é opcional. Os valores válidos para baud são 9600, 19200, 38400, 57600 e 115200. A taxa de transmissão padrão é 115200 bps.

DEBUGPORT:porta
Especifica a porta serial a ser usada como porta de depuração. Esta é uma configuração opcional. A porta padrão é 1 (COM 1).

Exemplo

O comando a seguir configura o computador de destino para usar uma conexão serial para depuração. O comando também especifica que a conexão de depuração usará COM1 e uma taxa de transmissão de 115.200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Para obter mais informações, consulte Configurando a depuração no modo kernel em um cabo serial manualmente.

USB

Especifica que o computador de destino e o computador host usarão uma conexão USB 2.0 ou USB 3.0 para depuração. Quando essa opção é usada, o parâmetro TARGETNAME também deve ser incluído.

TARGETNAME: targetname
Especifica um valor de cadeia de caracteres a ser usado para o nome de destino. Observe que TargetName não precisa ser o nome oficial do computador de destino; Pode ser qualquer cadeia de caracteres que você criar, desde que atenda a estas restrições:

  • A cadeia de caracteres não deve conter "debug" em nenhum lugar do TargetName em nenhuma combinação de letras maiúsculas ou minúsculas. Por exemplo, se você usar "DeBuG" ou "DEBUG" em qualquer lugar do seu targetname, a depuração não funcionará corretamente.
  • Os únicos caracteres na string são o hífen (-), o sublinhado (_), os dígitos de 0 a 9 e as letras de A a Z (maiúsculas ou minúsculas).
  • O comprimento máximo da cadeia de caracteres é de 24 caracteres.

Exemplo

O comando a seguir configura o computador de destino para usar a conexão USB para depuração. O comando também especifica um nome de destino que o computador host pode usar para se conectar ao computador de destino.

bcdedit /dbgsettings usb targetname:myTarget

Para saber mais, veja:

1394

Importante

O transporte 1394 está disponível para uso no Windows 10, versão 1607 e anterior. Ele não está disponível em versões posteriores do Windows. Você deve fazer a transição de seus projetos para outros transportes, como KDNET usando Ethernet. Para obter mais informações sobre esse transporte, consulte Configurando a depuração automática do kernel de rede KDNET.

Especifica que a máquina de destino e a máquina host usarão uma conexão IEEE 1394 (FireWire) para depuração. Quando essa opção é usada, o parâmetro CHANNEL também pode ser incluído.

CANAL:canal
(Usado apenas quando o tipo de conexão é 1394.) Especifica o canal 1394 a ser usado. O valor do canal deve ser um inteiro decimal entre 0 e 62, inclusive, e deve corresponder ao número do canal usado pelo computador host. O canal especificado neste parâmetro não depende da porta física 1394 escolhida no adaptador. O valor padrão para channel é 0.

Para obter mais informações, consulte Configurando a depuração do modo kernel em um cabo 1394 manualmente.

Configurações gerais do depurador

/start startpolicy
Essa opção especifica a política de início do depurador. A tabela a seguir mostra as opções para a startpolicy.

Opção Descrição
ACTIVE Especifica que o depurador de kernel está ativo.
ATIVAR AUTOMATICAMENTE Especifica que o depurador de kernel é habilitado automaticamente quando ocorre uma exceção ou outro evento crítico. Até lá, o depurador está ativo, mas está desabilitado.
DISABLE Especifica que o depurador de kernel está habilitado quando você digita kdbgctrl para limpar o bloco de habilitação. Até lá, o depurador está ativo, mas está desabilitado.

Se uma política de início não for especificada, ACTIVE será o padrão.

/noumex
Especifica que o depurador de kernel ignora exceções de modo de usuário. Por padrão, o depurador de kernel é interrompido para determinadas exceções do modo de usuário, como STATUS_BREAKPOINT e STATUS_SINGLE_STEP. O parâmetro /noumex é efetivo somente quando não há nenhum depurador de modo de usuário anexado ao processo.

Comentários

A opção /dbgsettings define as configurações de depuração, mas não habilita a depuração. Você deve usar a opção /debug para habilitar a depuração para uma entrada de inicialização específica. Se não houver configurações de depuração especificadas para uma entrada de inicialização específica, as configurações de depuração padrão serão usadas.

Os valores padrão para as configurações dbg são mostrados na tabela a seguir.

parâmetro dbgsetting Valor padrão
tipo de depuração Local
início de depuração Ativa
noumex Sim

Confira também

Para obter informações sobre as ferramentas de depuração do Windows, consulte Depuração do Windows.

Para obter informações sobre como instalar e configurar uma sessão de depuração no modo kernel, consulte Configurando a depuração do modo kernel manualmente e Configurando a depuração de kernel de rede KDNET automaticamente.