WinDbg : options de démarrage de ligne de commande

Démarrer WinDbg

Une fois WinDbg installé, WinDbgX.exe est disponible pour s’exécuter à partir de n’importe quel emplacement de répertoire.

Options de démarrage de ligne de commande

WinDbgX [options]

Les tableaux suivants résument les options de ligne de commande disponibles.

Options générales

Option	Description
`-c command`	Exécute une ligne de commande après l’attachement du débogueur. Cette commande doit être placée entre guillemets. Plusieurs commandes peuvent être séparées par des points-virgules.
`-v`	Active la sortie détaillée dans le débogueur.
`-T Title`	Définit le titre de la fenêtre.
`-logo LogFile`	Ouvrez le journal. Commence la journalisation des informations dans un fichier journal. Si le fichier existe déjà, il sera remplacé.
`-loga LogFile`	Ajout du journal. Commence la journalisation des informations dans un fichier journal. Si le fichier existe, il est ajouté.
`-e EventHandle`	Signale l’événement avec le handle donné après l’exception suivante dans une cible.
`-?`	Affiche un résumé des commandes disponibles.

Options du noyau

Option	Description
`-k \[ConnectType\]`	Démarre une session de débogage de noyau. Si -k est utilisé sans aucune option ConnectType suivante, il doit s’agir de l’entrée finale sur la ligne de commande.
`-kqm`	Démarre KD en mode silencieux.
`-kl`	Démarre une session de débogage du noyau sur la même machine que le débogueur.
`-kx ExdiOptions`	Démarre une session de débogage de noyau à l’aide d’un pilote EXDI. Pour plus d'informations sur EXDI, consultez Configuration du transport du débogueur EXDI.
`-I`	Après un redémarrage, le débogueur intervient sur l’ordinateur cible dès qu’un module noyau est chargé.

Options en mode utilisateur

Option	Description
`-o`	Débogue tous les processus lancés par l’application cible (processus enfants).
`-g`	Ignore le point d’arrêt initial dans l’application cible.
`-G`	Ignore le point d’arrêt final dans l’application cible.
`-pv`	Spécifie que le débogueur doit s’attacher au processus cible de manière nonvasive.
`-hd`	Spécifie que le tas de débogage ne doit pas être utilisé.
`-cimp`	Spécifie que tous les processus créés utilisent une ligne de commande implicite définie par le serveur au lieu d’une chaîne de ligne de commande donnée par l’utilisateur à partir du client.

Options cibles

Option	Description
`-remote ClientTransport`	Se connecte à un serveur de débogage déjà actif. Pour obtenir une explication des valeurs ClientTransport possibles, consultez Activation d’un client de débogage. Lorsque ce paramètre est utilisé, il doit s’agir des premiers paramètres de la ligne de commande.
`-server ServerTransport`	Crée un serveur de débogage accessible par d’autres débogueurs. Pour obtenir une explication des valeurs ServerTransport possibles, consultez Activation d’un serveur de débogage.
`-premote SmartClientTransport`	Crée un client intelligent et se connecte à un serveur de processus qui est déjà en cours d’exécution. Pour obtenir une explication des valeurs SmartClientTransport possibles, consultez Activation d’un client intelligent.
`-p PID`	Spécifie l'ID décimal du processus à déboguer.
`-tid TID`	Spécifie l’ID de thread d’un thread à reprendre lors du démarrage de la session de débogage.
`-psn ServiceName`	Spécifie le nom du service contenu dans le processus à déboguer. Il est utilisé pour déboguer un processus déjà en cours d’exécution.
`-pn ProcessName`	Spécifie le nom du processus à déboguer.
`-z DumpFile`	Spécifie le nom d'un fichier de vidage mémoire à déboguer. Si le chemin d’accès et le nom de fichier contiennent des espaces, cela doit être entouré de guillemets.
`-debugArch x86 -or- amd64`	Remplacez le comportement de détection automatique et définissez le bit cible pour le débogueur.
`-loadSession`	Chargez un fichier de configuration de session enregistré.
`-setupFirewallRules`	Configure les règles de pare-feu requises sur le système local pour autoriser le débogage du noyau à l’aide de KDNET.
`-openPrivateDumpByHandle Handle`	Utilisation interne de Microsoft uniquement. Spécifie le handle d’un fichier de vidage sur incident à déboguer.
`-benchmarkStartup`	Utilisation interne de Microsoft uniquement. Exécute un benchmark de démarrage et ajoute le résultat à un fichier.

Options de symboles

Option	Description
`-y SymbolPath`	Spécifie le chemin des symboles à utiliser. Séparez plusieurs chemins d’accès par un point-virgule ( ;). Si le chemin contient des espaces, il doit être placé entre guillemets. Pour plus d’informations et pour d’autres façons de modifier ce chemin, consultez Chemin d’accès aux symboles.
`-n`	Chargement de symboles bruyants. Active la sortie détaillée du gestionnaire de symboles.
`-i *ImagePath`	Définit le chemin de recherche d’images à utiliser.
`-sdce`	Provoque l’affichage des messages « Erreur d’accès aux fichiers » pendant le chargement des symboles.
`-ses`	Fait en sorte que le débogueur effectue une évaluation stricte de tous les fichiers de symboles et ignore les symboles questionnables.
`-sicv`	Provoque l’ignorer du gestionnaire de symboles.
`-sins`	Provoque l'ignorance par le débogueur des variables d'environnement de chemin d'accès aux symboles et au chemin des images exécutables.
`-snc`	Provoque la désactivation de la traduction de C++ par le débogueur.
`-snul`	Désactive le chargement automatique des symboles pour les noms non qualifiés.
`-sup`	Provoque la recherche du gestionnaire de symboles dans la table de symboles publiques pendant chaque recherche de symboles.
`-sflags`	Définit toutes les options du gestionnaire de symboles à la fois.

Options de chemin d’accès source

Option	Description
`-srcpath`	Spécifie le chemin d’accès source à utiliser sur le serveur de débogage.
`-lsrcpath`	Spécifie le chemin d’accès source à utiliser sur le client local.

Si vous êtes dans une session de débogueur locale, srcpath et lsrcpath sont effectivement identiques (votre « serveur » est votre session locale.) Pour le débogage à distance, il existe des situations où vous souhaiterez peut-être définir ces valeurs sur différentes valeurs. Pour plus d’informations sur le débogage à distance, consultez Débogage à distance.

Gestion des exceptions

Option	Description
`-x`	Activez la gestion de seconde chance uniquement pour les exceptions de violation d’accès.
`-xe Exception`	Activez la gestion des exceptions de première chance pour l’exception spécifiée.
`-xd Exception`	Activez la gestion des exceptions de seconde chance pour l’exception spécifiée.
`-xn Exception`	Pour l’exception donnée, désactivez la gestion des premières et des secondes chances et affichez uniquement un message sur la console.
`-xi Exception`	Ignorez complètement l’exception donnée, désactivant la gestion de première et deuxième chance, et ne mettant rien dans la console.

Pour obtenir la liste des exceptions qui peuvent être spécifiées, consultez Définitions d’événements et valeurs par défaut.

Post-mortem

Option	Description
`-I`	Définit WinDbg comme débogueur post-mortem par défaut pour le système.
`-IS`	Définit WinDbg comme débogueur post-mortem par défaut pour le système en mode silencieux, avec uniquement les erreurs signalées.

Options déconseillées

Option	Description
`-Q`	Option de ligne de commande déconseillée.
`-QY`	Option de ligne de commande déconseillée.
`-QS`	Option de ligne de commande déconseillée.
`-QSY`	Option de ligne de commande déconseillée.
`-WX`	Option de ligne de commande déconseillée.

Pour obtenir des informations générales sur les paramètres de démarrage, consultez Options Command-Line WinDbg.

Vous pouvez utiliser -? pour répertorier les options de ligne de commande prises en charge.

Capture d’écran de la sortie de l’aide en ligne de commande WinDbgX affichant différentes options.

Fonctionnalités WinDbg

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-10-09