Condividi tramite

BCDEdit /dbgsettings

  • Articolo

L'opzione /dbgsettings imposta o visualizza le impostazioni correnti del debugger globale per il computer. Per abilitare o disabilitare il debugger del kernel, usare l'opzione BCDEdit /debug .

Nota

Prima di impostare le opzioni BCDEdit, potrebbe essere necessario disabilitare o sospendere BitLocker e Avvio protetto nel computer.

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

Parametri

NET

Specifica che il computer di destinazione e il computer host useranno una connessione di rete Ethernet per il debug. Quando si usa questa opzione, è necessario includere anche i parametri HOSTIP e PORT . Il computer di destinazione deve avere una scheda di rete supportata da Strumenti di debug per Windows.

HOSTIP:ip
Per il debug di rete, specifica l'indirizzo IP del debugger host.

KEY:key
Per il debug di rete, specifica la chiave con cui crittografare la connessione. [0-9] e [a-z] sono consentiti solo. Non specificare questo parametro se è stato specificato il parametro newkey .

PORT:port
Per il debug di rete, specifica la porta con cui comunicare nel debugger host. Deve essere 49152 o superiore.

newkey
Per il debug di rete specifica che per la connessione deve essere generata una nuova chiave di crittografia. Non specificare questo parametro se è stato specificato un parametro KEY .

nodhcp

L'impostazione di nodhcp impedisce l'uso di DHCP per ottenere l'indirizzo IP di destinazione. Questa opzione è raramente necessaria perché anche i router di piccole dimensioni forniscono supporto per DHCP. L'opzione nodhcp deve essere usata solo se si sa che non sono presenti server DHCP nella rete. Nella maggior parte dei casi, il trasporto KDNET funziona meglio quando questa opzione non è impostata e DHCP è abilitato.

busparams=Bus.Device.Function Specifica il controller di destinazione. Bus specifica il numero di bus, Device specifica il numero di dispositivo e Function specifica il numero di funzione.

Per specificare i parametri del bus, Aprire Gestione dispositivi e individuare la scheda di rete da usare per il debug. Aprire la pagina delle proprietà per la scheda di rete e prendere nota del numero del bus, del numero del dispositivo e del numero di funzione. Questi valori vengono visualizzati in Gestione dispositivi in Posizione nella scheda Generale. In una finestra del prompt dei comandi con privilegi elevati immettere il comando seguente, dove b, d e f sono i numeri bus, dispositivo e funzione in formato decimale:

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

Se si configura manualmente una connessione al debugger, è necessario specificare i parametri del bus. Per altre informazioni, vedere Configurazione manuale del debug del kernel di rete KDNET e Configurazione del debug in modalità kernel su un cavo USB 3.0 manualmente.

Esempi

Il comando seguente configura il computer di destinazione per l'uso di una connessione Ethernet per il debug e specifica l'indirizzo IP del computer host. Il comando specifica anche un numero di porta che il computer host può usare per connettersi al computer di destinazione.

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

Il comando seguente imposta le impostazioni globali del debugger sul debug di rete usando IPv6 con un host del debugger alla porta 50000:48:d8:2f:5e:c0:42:28:4f5b che comunica sulla porta 50000:

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

Importante

La configurazione manuale di un debug di rete è un processo complesso e soggetto a errori. Per configurare automaticamente il debug di rete, vedere Configurazione automatica del debug del kernel di rete KDNET. L'uso dell'utilità KDNET è fortemente consigliato per tutti gli utenti del debugger.

Per altre informazioni sull'installazione manuale, vedere Configurazione manuale del debug in modalità kernel su un cavo di rete.

LOCAL

L'opzione LOCAL imposta l'opzione di debug globale sul debug locale. Questo è il debug in modalità kernel in un singolo computer. In altre parole, il debugger viene eseguito nello stesso computer di cui viene eseguito il debug. Con il debug locale è possibile esaminare lo stato, ma non interrompere i processi in modalità kernel che causano l'arresto dell'esecuzione del sistema operativo.

Esempio

Il comando seguente imposta le impostazioni globali del debugger sul debug locale.

bcdedit /dbgsettings LOCAL

L'opzione LOCAL è disponibile in Windows 8.0 e Windows Server 2012 e versioni successive.

Per informazioni sulla configurazione manuale del debug in modalità kernel locale, vedere Configurazione manuale del debug del kernel locale di un singolo computer.

SERIALE

Specifica che il computer di destinazione e il computer host useranno una connessione seriale per il debug. Quando si usa questa opzione, è necessario specificare i parametri DEBUGPORT e BAUDRATE .

BAUDRATE:baud
Specifica la velocità baud da utilizzare. Il parametro è facoltativo. I valori validi per baud sono 9600, 19200, 38400, 57600 e 115200. La velocità baud predefinita è 115200 bps.

DEBUGPORT:port
Specifica la porta seriale da utilizzare come porta di debug. Si tratta di un'impostazione facoltativa. La porta predefinita è 1 (COM 1).

Esempio

Il comando seguente configura il computer di destinazione per l'uso di una connessione seriale per il debug. Il comando specifica inoltre che la connessione di debug userà COM1 e una velocità baud pari a 115.200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Per altre informazioni, vedere Configurazione manuale del debug in modalità kernel su un cavo seriale.

USB

Specifica che il computer di destinazione e il computer host useranno una connessione USB 2.0 o USB 3.0 per il debug. Quando si usa questa opzione, è necessario includere anche il parametro TARGETNAME .

TARGETNAME: targetname
Specifica un valore stringa da utilizzare per il nome di destinazione. Si noti che TargetName non deve essere il nome ufficiale del computer di destinazione; può essere qualsiasi stringa creata, purché soddisfi queste restrizioni:

  • La stringa non deve contenere "debug" in qualsiasi punto di TargetName in qualsiasi combinazione di maiuscole o minuscole. Ad esempio, se si usa "DeBuG" o "DEBUG" in qualsiasi punto del nome di destinazione, il debug non funzionerà correttamente.
  • Gli unici caratteri nella stringa sono il trattino (-), il carattere di sottolineatura(_), le cifre da 0 a 9 e le lettere da A a Z (maiuscole o minuscole).
  • La lunghezza massima della stringa è di 24 caratteri.

Esempio

Il comando seguente configura il computer di destinazione per l'uso della connessione USB per il debug. Il comando specifica anche un nome di destinazione che il computer host può usare per connettersi al computer di destinazione.

bcdedit /dbgsettings usb targetname:myTarget

Per altre informazioni, vedi:

1394

Importante

Il trasporto 1394 è disponibile per l'uso in Windows 10 versione 1607 e precedenti. Non è disponibile nelle versioni successive di Windows. È consigliabile eseguire la transizione dei progetti ad altri trasporti, ad esempio KDNET tramite Ethernet. Per altre informazioni sul trasporto, vedere Configurazione automatica del debug del kernel di rete KDNET.

Specifica che il computer di destinazione e il computer host useranno una connessione IEEE 1394 (FireWire) per il debug. Quando si usa questa opzione, è possibile includere anche il parametro CHANNEL .

CHANNEL:channel
(Usato solo quando il tipo di connessione è 1394. Specifica il canale 1394 da usare. Il valore per channel deve essere un numero intero decimale compreso tra 0 e 62 inclusi e deve corrispondere al numero di canale utilizzato dal computer host. Il canale specificato in questo parametro non dipende dalla porta fisica 1394 scelta sull'adattatore. Il valore predefinito per channel è 0.

Per altre informazioni, vedere Configurazione manuale del debug in modalità kernel su un cavo 1394.

Impostazioni generali del debugger

/start startpolicy
Questa opzione specifica i criteri di avvio del debugger. Nella tabella seguente vengono illustrate le opzioni per il criterio di avvio.

Opzione Descrizione
ACTIVE Specifica che il debugger del kernel è attivo.
AUTOENABLE Specifica che il debugger del kernel viene abilitato automaticamente quando si verifica un'eccezione o un altro evento critico. Fino ad allora, il debugger è attivo ma è disabilitato.
DISABLE Specifica che il debugger del kernel è abilitato quando si digita kdbgctrl per cancellare il blocco di abilitazione. Fino ad allora, il debugger è attivo ma è disabilitato.

Se non viene specificato un criterio di avvio, ACTIVE è l'impostazione predefinita.

/noumex
Specifica che il debugger del kernel ignora le eccezioni in modalità utente. Per impostazione predefinita, il debugger del kernel si interrompe per determinate eccezioni in modalità utente, ad esempio STATUS_BREAKPOINT e STATUS_SINGLE_STEP. Il parametro /noumex è efficace solo quando non è presente alcun debugger in modalità utente collegato al processo.

Commenti

L'opzione /dbgsettings configura le impostazioni di debug, ma non abilita il debug. È necessario usare l'opzione /debug per abilitare il debug per una voce di avvio specifica. Se non sono specificate impostazioni di debug per una voce di avvio specifica, vengono usate le impostazioni di debug predefinite.

I valori predefiniti per dbgsettings sono illustrati nella tabella seguente.

parametro dbgsetting Valore predefinito
debugtype Locale
debugstart Attive
noumex Sì

Vedi anche

Per informazioni sugli strumenti di debug di Windows, vedere Debug di Windows.

Per informazioni sulla configurazione e la configurazione di una sessione di debug in modalità kernel, vedere Configurazione manuale del debug in modalità kernel e Configurazione automatica del debug del kernel di rete KDNET.