BCDEdit /dbgsettings

  • Article

L’option /dbgsettings définit ou affiche les paramètres du débogueur global actuel pour l’ordinateur. Pour activer ou désactiver le débogueur de noyau, utilisez l’option BCDEdit /debug .

Notes

Avant de définir les options BCDEdit, vous devrez peut-être désactiver ou suspendre BitLocker et le démarrage sécurisé sur l’ordinateur.

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

Paramètres

NET

Spécifie que l’ordinateur cible et l’ordinateur hôte utiliseront une connexion réseau Ethernet pour le débogage. Lorsque cette option est utilisée, les paramètres HOSTIP et PORT doivent également être inclus. L’ordinateur cible doit disposer d’une carte réseau prise en charge par les Outils de débogage pour Windows.

HOSTIP :ip
Pour le débogage réseau, spécifie l’adresse IP du débogueur hôte.

KEY :key
Pour le débogage réseau, spécifie la clé avec laquelle chiffrer la connexion. [0-9] et [a-z] autorisés uniquement. Ne spécifiez pas ce paramètre si vous avez spécifié le paramètre newkey .

PORT :port
Pour le débogage réseau, spécifie le port avec lequel communiquer sur le débogueur hôte. Doit être 49152 ou supérieur.

newkey
Pour le débogage réseau, spécifie qu’une nouvelle clé de chiffrement doit être générée pour la connexion. Ne spécifiez pas ce paramètre si vous avez spécifié un paramètre KEY .

nodhcp

La définition de nodhcp empêche l’utilisation de DHCP pour obtenir l’adresse IP cible. Cette option est rarement nécessaire, car même les petits routeurs prennent en charge DHCP. L’option nodhcp ne doit être utilisée que si vous savez qu’il n’existe aucun serveur DHCP sur le réseau. Dans la plupart des cas, le transport KDNET fonctionne mieux lorsque cette option n’est pas définie et que DHCP est activé.

busparams=Bus.Device.Function Spécifie le contrôleur cible. Bus spécifie le numéro de bus, Device spécifie le numéro d’appareil et Function spécifie le numéro de la fonction.

Pour spécifier les paramètres de bus, ouvrez Gestionnaire de périphériques et recherchez la carte réseau que vous souhaitez utiliser pour le débogage. Ouvrez la page de propriétés de la carte réseau et notez le numéro de bus, le numéro d’appareil et le numéro de fonction. Ces valeurs sont affichées dans Gestionnaire de périphériques sous Emplacement sous l’onglet Général. Dans une fenêtre d’invite de commandes avec élévation de privilèges, entrez la commande suivante, où b, d et f sont les numéros de bus, d’appareil et de fonction au format décimal :

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

Si vous configurez manuellement une connexion de débogueur, vous devez spécifier les paramètres de bus. Pour plus d’informations, consultez Configuration manuelle du débogage du noyau réseau KDNET et Configuration manuelle du débogage Kernel-Mode sur un câble USB 3.0.

Exemples

La commande suivante configure l’ordinateur cible pour qu’il utilise une connexion Ethernet pour le débogage et spécifie l’adresse IP de l’ordinateur hôte. La commande spécifie également un numéro de port que l’ordinateur hôte peut utiliser pour se connecter à l’ordinateur cible.

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

La commande suivante définit les paramètres du débogueur global sur le débogage réseau à l’aide d’IPv6 avec un hôte de débogueur à l’adresse 2001 :48 :d8 :2f :5e :c0 :42 :28 :4f5b communiquant sur le port 50000 :

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

Important

La configuration manuelle d’un débogage réseau est un processus complexe et sujet aux erreurs. Pour configurer automatiquement le débogage réseau, consultez Configuration automatique du débogage du noyau réseau KDNET. L’utilisation de l’utilitaire KDNET est fortement recommandée pour tous les utilisateurs du débogueur.

Pour plus d’informations sur la configuration manuelle, consultez Configuration manuelle Kernel-Mode débogage sur un câble réseau.

LOCAL

L’option LOCAL définit l’option de débogage global sur débogage local. Il s’agit du débogage en mode noyau sur un seul ordinateur. En d’autres termes, le débogueur s’exécute sur le même ordinateur que celui en cours de débogage. Avec le débogage local, vous pouvez examiner l’état, mais ne pas interrompre les processus en mode noyau qui entraîneraient l’arrêt de l’exécution du système d’exploitation.

Exemple

La commande suivante définit les paramètres du débogueur global sur le débogage local.

bcdedit /dbgsettings LOCAL

L’option LOCAL est disponible dans Windows 8.0 et Windows Server 2012 et versions ultérieures.

Pour plus d’informations sur la configuration manuelle du débogage en mode noyau local, consultez Configuration manuelle du débogage du noyau local d’un seul ordinateur.

SERIAL

Spécifie que l’ordinateur cible et l’ordinateur hôte utiliseront une connexion série pour le débogage. Lorsque cette option est utilisée, les paramètres DEBUGPORT et BAUDRATE doivent être spécifiés.

BAUDRATE :baud
Spécifie le taux de bauds à utiliser. Ce paramètre est facultatif. Les valeurs valides pour baud sont 9600, 19200, 38400, 57600 et 115200. Le taux de baud par défaut est de 115200 bps.

DEBUGPORT :port
Spécifie le port série à utiliser comme port de débogage. Ce paramètre est facultatif. Le port par défaut est 1 (COM 1).

Exemple

La commande suivante configure l’ordinateur cible pour qu’il utilise une connexion série pour le débogage. La commande spécifie également que la connexion de débogage utilisera COM1 et un taux de bauds de 115 200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Pour plus d’informations, consultez Configuration manuelle Kernel-Mode débogage sur un câble série.

USB

Spécifie que l’ordinateur cible et l’ordinateur hôte utiliseront une connexion USB 2.0 ou USB 3.0 pour le débogage. Lorsque cette option est utilisée, le paramètre TARGETNAME doit également être inclus.

TARGETNAME :targetname
Spécifie une valeur de chaîne à utiliser pour le nom cible. Notez que TargetName ne doit pas être le nom officiel de l’ordinateur cible ; Il peut s’agir de n’importe quelle chaîne que vous créez tant qu’elle respecte ces restrictions :

  • La chaîne ne doit pas contenir « debug » n’importe où dans targetName dans une combinaison de majuscules ou minuscules. Par exemple, si vous utilisez « DeBuG » ou « DEBUG » n’importe où dans votre nom de cible, le débogage ne fonctionnera pas correctement.
  • Les seuls caractères de la chaîne sont le trait d’union (-), le trait de soulignement(_), les chiffres 0 à 9 et les lettres A à Z (majuscules ou minuscules).
  • La longueur maximale de la chaîne est de 24 caractères.

Exemple

La commande suivante configure l’ordinateur cible pour utiliser la connexion USB pour le débogage. La commande spécifie également un nom de cible que l’ordinateur hôte peut utiliser pour se connecter à l’ordinateur cible.

bcdedit /dbgsettings usb targetname:myTarget

Pour plus d'informations, consultez les pages suivantes :

1394

Important

Le transport 1394 est disponible dans Windows 10, version 1607 et antérieure. Il n’est pas disponible dans les versions ultérieures de Windows. Vous devez faire passer vos projets à d’autres transports, tels que KDNET à l’aide d’Ethernet. Pour plus d’informations sur ce transport, consultez Configuration automatique du débogage du noyau de réseau KDNET.

Spécifie que l’ordinateur cible et l’ordinateur hôte utiliseront une connexion IEEE 1394 (FireWire) pour le débogage. Lorsque cette option est utilisée, le paramètre CHANNEL peut également être inclus.

CHANNEL :channel
(Utilisé uniquement lorsque le type de connexion est 1394.) Spécifie le canal 1394 à utiliser. La valeur du canal doit être un entier décimal compris entre 0 et 62, inclus, et doit correspondre au numéro de canal utilisé par l’ordinateur hôte. Le canal spécifié dans ce paramètre ne dépend pas du port physique 1394 choisi sur l’adaptateur. La valeur par défaut du canal est 0.

Pour plus d’informations, consultez Configuration manuelle Kernel-Mode débogage sur un câble 1394.

Paramètres généraux du débogueur

/startstartpolicy
Cette option spécifie la stratégie de démarrage du débogueur. Le tableau suivant présente les options de la stratégie de démarrage.

Option Description
ACTIVE Spécifie que le débogueur de noyau est actif.
AUTOENABLE Spécifie que le débogueur du noyau est activé automatiquement lorsqu’une exception ou un autre événement critique se produit. En attendant, le débogueur est actif, mais est désactivé.
DISABLE Spécifie que le débogueur de noyau est activé lorsque vous tapez kdbgctrl pour effacer le bloc d’activation. En attendant, le débogueur est actif, mais est désactivé.

Si aucune stratégie de démarrage n’est spécifiée, ACTIVE est la valeur par défaut.

/noumex
Spécifie que le débogueur du noyau ignore les exceptions en mode utilisateur. Par défaut, le débogueur du noyau s’arrête pour certaines exceptions en mode utilisateur, telles que STATUS_BREAKPOINT et STATUS_SINGLE_STEP. Le paramètre /noumex est efficace uniquement lorsqu’aucun débogueur en mode utilisateur n’est attaché au processus.

Commentaires

L’option /dbgsettings configure les paramètres de débogage, mais n’active pas le débogage. Vous devez utiliser l’option /debug pour activer le débogage pour une entrée de démarrage spécifique. Si aucun paramètre de débogage n’est spécifié pour une entrée de démarrage particulière, les paramètres de débogage par défaut sont utilisés.

Les valeurs par défaut des dbgsettings sont indiquées dans le tableau suivant.

paramètre dbgsetting Valeur par défaut
debugtype Local
debugstart Actif
noumex Oui

Voir aussi

Pour plus d’informations sur les outils de débogage Windows, consultez Débogage Windows.

Pour plus d’informations sur la configuration et la configuration d’une session de débogage en mode noyau, consultez Configuration du débogage Kernel-Mode manuellement et Configuration automatique du débogage du noyau réseau KDNET.