WinDbg: Befehlszeilenstartoptionen

Starten von WinDbg

Nach der Installation von WinDbg kann WinDbgX.exe in jedem Verzeichnis ausgeführt werden.

Befehlszeilenstartoptionen

WinDbgX [options]

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

Allgemeine Optionen

Option	Description
`-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`	Ermöglicht eine detaillierte Ausgabe im Debugger.
`-T Title`	Legt den Fenstertitel fest.
`-logo LogFile`	Protokoll öffnen. 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 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	Description
`-k \[ConnectType\]`	Startet eine Kerneldebuggingsitzung. Wenn "-k" ohne ConnectType-Optionen verwendet wird, muss es sich um den endgültigen Eintrag in der Befehlszeile handelt.
`-kqm`	Startet KD im leisen Modus.
`-kl`	Startet eine Kerneldebuggingsitzung auf demselben Computer wie der Debugger.
`-kx ExdiOptions`	Startet eine Kerneldebugsitzung mit einem EXDI-Treiber. Weitere Informationen zu EXDI finden Sie unter Configuring the EXDI Debugger Transport.
`-I`	Nach einem Neustart wechselt der Debugger in den Zielcomputer, sobald ein Kernelmodul geladen wird.

Optionen für den Benutzermodus

Option	Description
`-o`	Debugt 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 Debug-Heap nicht verwendet werden soll.
`-cimp`	Gibt an, dass alle erstellten Prozesse eine implizite Befehlszeile verwenden, die vom Server anstelle einer vom Benutzer angegebenen Befehlszeilenzeichenfolge vom Client festgelegt wird.

Zieloptionen

Option	Description
`-remote ClientTransport`	Stellt eine Verbindung zu einem bereits laufenden Debug-Server her. Eine Erläuterung der möglichen ClientTransport-Werte finden Sie unter Aktivieren eines Debugclients. Wenn dieser Parameter verwendet wird, muss er die ersten Parameter in der Befehlszeile sein.
`-server ServerTransport`	Erstellt einen Debugserver, auf den von anderen Debuggern zugegriffen werden kann. 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 bereit, der bereits ausgeführt wird. Eine Erläuterung der möglichen SmartClientTransport-Werte finden Sie unter Aktivieren eines Smart Client.
`-p PID`	Gibt die dezimale Prozess-ID an, die gedebuggt werden soll.
`-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 Prozess enthalten ist, der gedebuggt werden soll. 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 Absturzabbilddatei an, die gedebuggt werden soll. Wenn der Pfad und der Dateiname Leerzeichen enthalten, muss dies 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 im lokalen System, um das Kerneldebugging mit KDNET zuzulassen.
`-openPrivateDumpByHandle Handle`	Nur die interne Verwendung von Microsoft. Gibt das Handle einer Crash-Dump-Datei an, zum Debuggen.
`-benchmarkStartup`	Nur die interne Verwendung von Microsoft. Führt einen Start-Benchmark aus und fügt das Ergebnis an eine Datei an.

Symboloptionen

Option	Description
`-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. Ausführliche Informationen und weitere Möglichkeiten zum Ändern dieses Pfads finden Sie unter "Symbolpfad".
`-n`	Laute Symbolbedienung. Aktiviert die ausführliche Ausgabe des Symbolhandlers.
`-i *ImagePath`	Legt den zu verwendenden Bildsuchpfad fest.
`-sdce`	Verursacht, dass der Debugger während des Ladens von Symbolen "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.
`-sins`	Bewirkt, dass der Debugger die Symbolpfad- und ausführbaren Bildpfad-Umgebungsvariablen ignoriert.
`-snc`	Bewirkt, dass der Debugger die C++-Übersetzung deaktiviert.
`-snul`	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 auf einmal fest.

Quellpfadoptionen

Option	Description
`-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 effektiv gleich (Ihr "Server" ist Ihre lokale Sitzung.) Für das Remotedebugging gibt es Situationen, in denen Sie diese auf unterschiedliche Werte festlegen möchten. Weitere Informationen zum Remotedebugging finden Sie unter Remotedebugging.

Ausnahmenbehandlung

Option	Description
`-x`	Aktivieren Sie die Behandlung von zweiten Chancen nur für Zugriffsverletzungsausnahmen.
`-xe Exception`	Aktivieren Sie die Ausnahmebehandlung beim ersten Auftreten der angegebene Ausnahme.
`-xd Exception`	Aktivieren Sie die Ausnahmebehandlung mit zweiter Chance für die angegebene Ausnahme.
`-xn Exception`	Deaktivieren Sie für die gegebene Ausnahme die First- und Second-Chance-Behandlung, und zeigen Sie nur eine Meldung auf der Konsole an.
`-xi Exception`	Ignorieren Sie die gegebene Ausnahme vollständig, deaktivieren Sie die First- und Second-Chance-Behandlung, und geben Sie nichts an die Konsole aus.

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

Obduktion

Option	Description
`-I`	Legt WinDbg als standardmäßigen Post-Mortem-Debugger für das System fest.
`-IS`	Legt WinDbg als standardmäßigen Post-Mortem-Debugger für das System im Hintergrund fest, wobei nur Fehler gemeldet werden.

Veraltete Optionen

Option	Description
`-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 die -? unterstützten Befehlszeilenoptionen auflisten.

Screenshot der WinDbgX-Befehlszeilenhilfeausgabe, in der verschiedene Optionen angezeigt werden.

WinDbg-Features

Feedback

War diese Seite hilfreich?

Last updated on 2025-10-09