Partager via

BCDEdit /dbgsettings

  • Article

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

Remarque

Avant de définir les options de 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 utilisent 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 avoir 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 le mieux lorsque cette option n’est pas définie, et DHCP est activé.

busparams=Bus.Device.Function Spécifie le contrôleur cible. Bus spécifie le numéro de bus, l’appareil spécifie le numéro d’appareil et la fonction spécifie le numéro de 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 du débogage en mode noyau sur un câble USB 3.0 manuellement.

Exemples

La commande suivante configure l’ordinateur cible pour utiliser 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 globaux du débogueur 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 sujette aux erreurs. Pour une configuration automatique du débogage réseau, consulter la configuration automatique du débogage réseau du noyau 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 du débogage en mode noyau sur un câble réseau manuellement.

Pour plus d’informations sur l’émulation Ethernet sur USB, consultez Configuration du débogage en mode noyau sur USB EEM à l’aide de KDNET

LOCAL

L’option LOCAL définit l’option de débogage global sur le 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 qui est débogué. Avec le débogage local, vous pouvez examiner l’état, mais pas décomposer les processus en mode noyau qui entraîneraient l’arrêt du système d’exploitation.

Exemple

La commande suivante définit les paramètres globaux du débogueur 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 ordinateur unique.

FEUILLETON

Spécifie que l’ordinateur cible et l’ordinateur hôte utilisent 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 baud à 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 utiliser 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 baud de 115 200.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

Pour plus d’informations, consultez Configuration manuelle du débogage en mode noyau sur un câble série.

USB

Spécifie que la machine cible et la machine hôte utilisent 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 répond à ces restrictions :

  • La chaîne ne doit pas contenir de « débogage » n’importe où dans targetName dans une combinaison de majuscules ou minuscules. Par exemple, si vous utilisez « Déboguer » ou « DEBUG » n’importe où dans votre nom cible, le débogage ne fonctionne 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 (majuscule ou minuscule).
  • 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 cible que l’ordinateur hôte peut utiliser pour se connecter à l’ordinateur cible.

bcdedit /dbgsettings usb targetname:myTarget

Pour plus d’informations, consultez l’article suivant :

1394

Important

Le transport 1394 est disponible pour une utilisation dans Windows 10, version 1607 et versions antérieures. Il n’est pas disponible dans les versions ultérieures de Windows. Vous devez transférer vos projets vers 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 réseau KDNET.

Spécifie que l’ordinateur cible et l’ordinateur hôte utilisent 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.

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

/startpolicy
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 du 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. Jusqu’à ce moment, le débogueur est actif, mais est désactivé.
DISABLE Spécifie que le débogueur du noyau est activé lorsque vous tapez kdbgctrl pour effacer le bloc d’activation. Jusqu’à ce moment, 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’il n’existe aucun débogueur en mode utilisateur 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. S’il n’existe aucun paramètre de débogage 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 Activé
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 manuelle du débogage en mode noyau et configuration automatique du débogage du noyau réseau KDNET.