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 sicuro 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 viene usata questa opzione, è necessario includere anche i parametri HOSTIP e PORT . Il computer di destinazione deve avere una scheda di rete supportata dagli 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] consentito 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. Dovrebbe essere 49152 o superiore.

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

nodhcp

L'impostazione 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 delle situazioni, il trasporto KDNET funziona meglio quando questa opzione non è impostata e DHCP è abilitata.

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

Per specificare i parametri del bus, Aprire Gestione dispositivi e individuare la scheda di rete che si vuole usare per il debug. Aprire la pagina delle proprietà per la scheda di rete e prendere nota del numero del bus, del numero di 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 il bus, il dispositivo e i numeri di 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 manuale del debug Kernel-Mode su un cavo USB 3.0.

Esempio

Il comando seguente configura il computer di destinazione per usare 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 del debugger globale per il 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 di un debug di rete manualmente è 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 Kernel-Mode su un cavo di rete manualmente.

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 in cui viene eseguito il debug. Con il debug locale è possibile esaminare lo stato, ma non interrompere i processi in modalità kernel che causerebbero l'arresto dell'esecuzione del sistema operativo.

Esempio

Il comando seguente imposta le impostazioni del debugger globale per il 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 viene usata questa opzione, è necessario specificare i parametri DEBUGPORT e BAUDRATE .

BAUDRATE:baud
Specifica la velocità baud da usare. Questo parametro è facoltativo e, 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 usare 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 usare una connessione seriale per il debug. Il comando specifica inoltre che la connessione di debug userà COM1 e una velocità baud di 115.200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Per altre informazioni, vedere Configurazione di Kernel-Mode debug su un cavo seriale manualmente.

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 viene usata questa opzione, è necessario includere anche il parametro TARGETNAME .

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

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

Esempio

Il comando seguente configura il computer di destinazione per usare la 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, vedere:

1394

Importante

Il trasporto 1394 è disponibile per l'uso in Windows 10, versione 1607 e versioni precedenti. Non è disponibile nelle versioni successive di Windows. È consigliabile passare i progetti ad altri trasporti, ad esempio KDNET usando 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 viene usata questa opzione, il parametro CHANNEL può essere incluso anche.

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

Per altre informazioni, vedere Configurazione Kernel-Mode debug su un cavo 1394 manualmente.

Impostazioni del debugger generale

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

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 a 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 a allora, il debugger è attivo ma è disabilitato.

Se non viene specificato un criterio di avvio, ACTIVE è il valore predefinito.

/noumex
Specifica che il debugger del kernel ignora le eccezioni in modalità utente. Per impostazione predefinita, il debugger del kernel interrompe alcune 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 i dbgsetting vengono visualizzati nella tabella seguente.

parametro dbgsetting Valore predefinito
debugtype Locale
debugstart Attivo
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 Kernel-Mode e Configurazione automatica del debug del kernel di rete KDNET.