WinDbg– Startoptionen für die Befehlszeile

Starten von WinDbg

Nach der Installation von WinDbg ist WinDbgX.exe für die Ausführung von einem beliebigen Verzeichnisspeicherort verfügbar.

Befehlszeilenstartoptionen

WinDbgX [options]

In den folgenden Tabellen sind die verfügbaren Befehlszeilenoptionen zusammengefasst.

Allgemeine Optionen

Option	BESCHREIBUNG
-c "Command"	Führt eine Befehlszeile aus, nachdem der Debugger angefügt wurde. Dieser Befehl muss in Anführungszeichen eingeschlossen werden. Mehrere Befehle können durch Semikolons getrennt werden.
-v	Aktiviert die ausführliche Ausgabe im Debugger.
-T Titel	Legt den Fenstertitel fest.
-logo LogFile	Protokoll geöffnet. Beginnt mit der Protokollierung von Informationen in einer Protokolldatei. Wenn die Datei bereits vorhanden ist, wird sie überschrieben.
-loga LogFile	Protokollanfüge. Beginnt mit der Protokollierung von Informationen in einer Protokolldatei. Wenn die Datei vorhanden ist, wird sie an angefügt.
-e EventHandle	Signalisiert das Ereignis mit dem angegebenen Handle nach der nächsten Ausnahme in einem Ziel.
-?	Zeigt eine Zusammenfassung der verfügbaren Befehle an.

Kerneloptionen

Option	BESCHREIBUNG
-k [ConnectType]	Startet eine Kerneldebugsitzung. Wenn -k verwendet wird, ohne dass connectType-Optionen darauf folgen, muss dies der letzte Eintrag in der Befehlszeile sein.
-kqm	Startet KD im stillen Modus.
-Kl	Startet eine Kerneldebugsitzung auf demselben Computer wie der Debugger.
-kx ExdiOptions	Startet eine Kerneldebugsitzung mit einem EXDI-Treiber. Weitere Informationen zu EXDI finden Sie unter Konfigurieren des EXDI-Debuggertransports.
-d	Nach einem Neustart wird der Debugger in den Zielcomputer eingebrochen, sobald ein Kernelmodul geladen wird.

Benutzermodusoptionen

Option	BESCHREIBUNG
-o	Debuggt alle Prozesse, die von der Zielanwendung (untergeordnete Prozesse) gestartet werden.
-g	Ignoriert den anfänglichen Haltepunkt in der Zielanwendung.
-G	Ignoriert den endgültigen Haltepunkt in der Zielanwendung.
-Pv	Gibt an, dass der Debugger nicht invasiv an den Zielprozess angefügt werden soll.
-Hd	Gibt an, dass der Debugheap nicht verwendet werden soll.
-cimp	Gibt an, dass alle erstellten Prozesse eine vom Server festgelegte implizite Befehlszeile anstelle einer vom Benutzer angegebenen Befehlszeilenzeichenfolge vom Client verwenden.

Zieloptionen

Option	BESCHREIBUNG
-remote ClientTransport	Stellt eine Verbindung mit einem Debugserver her, der bereits ausgeführt wird. Eine Erläuterung der möglichen ClientTransport-Werte finden Sie unter Aktivieren eines Debugclients. Wenn dieser Parameter verwendet wird, muss es sich um die ersten Parameter in der Befehlszeile handelt.
-server ServerTransport	Erstellt einen Debugserver, auf den andere Debugger zugreifen können. Eine Erläuterung der möglichen ServerTransport-Werte finden Sie unter Aktivieren eines Debugservers.
-premote SmartClientTransport	Erstellt einen intelligenten Client und stellt eine Verbindung mit einem Prozessserver her, der bereits ausgeführt wird. Eine Erläuterung der möglichen SmartClientTransport-Werte finden Sie unter Aktivieren eines smarten Clients.
-p PID	Gibt die zu debuggende Dezimalprozess-ID an.
-tid TID	Gibt die Thread-ID eines Threads an, der fortgesetzt werden soll, wenn die Debugsitzung gestartet wird.
-psn ServiceName	Gibt den Namen des Diensts an, der im zu debuggenden Prozess enthalten ist. Dies wird verwendet, um einen Prozess zu debuggen, der bereits ausgeführt wird.
-pn ProcessName	Gibt den Namen des zu debuggenden Prozesses an.
-z DumpFile	Gibt den Namen einer zu debuggenden Absturzabbilddatei an. Wenn pfad und Dateiname Leerzeichen enthalten, müssen diese von Anführungszeichen umgeben sein.
-debugArch x86 -or- amd64	Überschreiben Sie das Verhalten der automatischen Erkennung, und legen Sie die Zielbitanzahl für den Debugger fest.
-loadSession	Laden Sie eine gespeicherte Sitzungskonfigurationsdatei.
-setupFirewallRules	Konfiguriert die erforderlichen Firewallregeln auf dem lokalen System, um das Kerneldebuggen mithilfe von KDNET zu ermöglichen.
-openPrivateDumpByHandle-Handle	Nur interne Verwendung von Microsoft. Gibt das Handle einer zu debuggenden Absturzabbilddatei an.
-benchmarkStartup	Nur interne Verwendung von Microsoft. Führt einen Startvergleichstest aus und fügt das Ergebnis an eine Datei an.

Symboloptionen

Option	BESCHREIBUNG
-y SymbolPath	Gibt den zu verwendenden Symbolpfad an. Trennen Sie mehrere Pfade durch ein Semikolon (;). Wenn der Pfad Leerzeichen enthält, sollte er in Anführungszeichen eingeschlossen werden. Weitere Informationen und weitere Möglichkeiten zum Ändern dieses Pfads finden Sie unter Symbolpfad.
-n	Lautes Laden von Symbolen. Aktiviert die ausführliche Ausgabe des Symbolhandlers.
-i ImagePath	Legt den zu verwendenden Bildsuchpfad fest.
-sdce	Bewirkt, dass der Debugger während des Ladens des Symbols "Dateizugriffsfehler" anzeigt.
-Ses	Bewirkt, dass der Debugger eine strikte Auswertung aller Symboldateien durchführt und alle fragwürdigen Symbole ignoriert.
-sicv	Bewirkt, dass der Symbolhandler den CV-Eintrag ignoriert.
-Sünden	Bewirkt, dass der Debugger die Umgebungsvariablen Symbolpfad und ausführbare Imagepfade ignoriert.
-Snc	Bewirkt, dass der Debugger die C++-Übersetzung deaktiviert.
-snulul	Deaktiviert das automatische Laden von Symbolen für nicht qualifizierte Namen.
-Sup	Bewirkt, dass der Symbolhandler während jeder Symbolsuche die öffentliche Symboltabelle durchsucht.
-sflags	Legt alle Symbolhandleroptionen gleichzeitig fest.

Optionen für Quellpfade

Option	BESCHREIBUNG
-srcpath	Gibt den Quellpfad an, der auf dem Debugserver verwendet werden soll.
-lsrcpath	Gibt den Quellpfad an, der auf dem lokalen Client verwendet werden soll.

Wenn Sie sich in einer lokalen Debuggersitzung befinden, sind srcpath und lsrcpath im Grunde identisch (Ihr "Server" ist Ihre lokale Sitzung). Für das Remotedebuggen gibt es Situtationen, an denen Sie diese auf unterschiedliche Werte festlegen möchten. Weitere Informationen zum Remotedebuggen finden Sie unter Remotedebuggen.

Ausnahmebehandlung

Option	BESCHREIBUNG
-X	Aktivieren Sie die Behandlung der zweiten Chance nur für Ausnahmen bei Zugriffsverletzungen.
- xe-Ausnahme	Aktivieren Sie die Ausnahmebehandlung der ersten Chance für die angegebene Ausnahme.
- xd-Ausnahme	Aktivieren Sie die Ausnahmebehandlung mit zweiter Chance für die angegebene Ausnahme.
- xn-Ausnahme	Deaktivieren Sie für die angegebene Ausnahme die Behandlung der ersten und zweiten Chance, und zeigen Sie nur eine Meldung auf der Konsole an.
- xi-Ausnahme	Ignorieren Sie die angegebene Ausnahme vollständig, deaktivieren Sie die Behandlung der ersten und zweiten Chance, und geben Sie nichts an die Konsole aus.

Eine Liste der Ausnahmen, die angegeben werden können, finden Sie unter Ereignisdefinitionen und Standardwerte.

Post Mortem

Option	BESCHREIBUNG
-I	Legt WinDbg als Standarddebugger für das System fest.
-IST	Legt WinDbg als standardmäßigen Post mortem-Debugger für das System im Hintergrund fest, wobei nur Fehler gemeldet werden.

Veraltete Optionen

Option	BESCHREIBUNG
-Q	Veraltete Befehlszeilenoption.
-QY	Veraltete Befehlszeilenoption.
-QS	Veraltete Befehlszeilenoption.
-QSY	Veraltete Befehlszeilenoption.
–WX	Veraltete Befehlszeilenoption.

Allgemeine Informationen zu den Startparametern finden Sie unter WinDbg Command-Line-Optionen.

Sie können -? , um die unterstützten Befehlszeilenoptionen auflisten zu können.

Weitere Informationen

WinDbg-Features