Dieser Browser wird nicht mehr unterstützt.
Führen Sie ein Upgrade auf Microsoft Edge durch, um die neuesten Features, Sicherheitsupdates und den technischen Support zu nutzen.
Indem Sie Befehlszeilenoptionen mit MSBuild verwenden, können Sie angeben, wie viele Builddaten zu überprüfen sind und ob Sie Builddaten in eine oder mehrere Dateien speichern möchten. Sie können auch eine benutzerdefinierte Protokollierung zum Sammeln von Builddaten angeben. Weitere Informationen zu MSBuild-Befehlszeilenoptionen, die in diesem Thema nicht behandelt werden, finden Sie unter Befehlszeilenreferenz.
Hinweis
Wenn Sie Projekte mithilfe von Visual Studio-IDE erstellen, können Sie die Probleme diese Builds beheben, indem Sie Buildprotokolle überprüfen. Weitere Informationen finden Sie unter Vorgehensweise: Anzeigen, Speichern und Konfigurieren von Buildprotokolldateien.
Wenn Sie ein Projekt mithilfe von MSBuild ohne Angabe einer Detailebene erstellen, werden die folgenden Informationen im Ausgabeprotokoll angezeigt:
Fehler, Warnungen und Nachrichten, die als äußerst wichtig eingestuft werden.
Einige Statusereignisse.
Eine Übersicht des Build.
Mithilfe des Schalters -verbosity ( -v) können Sie steuern, wie viele Daten im Ausgabeprotokoll angezeigt werden. Verwenden Sie für die Problembehandlung entweder den Ausführlichkeitsgrad detailed (d) oder diagnostic (diag), der die meisten Informationen bietet.
Der Buildprozess ist möglicherweise langsamer, wenn Sie -verbosity auf detailed festlegen, und sogar noch langsamer, wenn Sie -verbosity auf diagnostic festlegen.
msbuild MyProject.proj -t:go -v:diag
In der folgenden Tabelle wird gezeigt, wie sich die Ausführlichkeit der Protokolle (Spaltenwerte) darauf auswirkt, welche Nachrichtentypen (Zeilenwerte) protokolliert werden.
| Nachrichtentyp/Ausführlichkeit | Quiet | Minimal | Normal | Detailliert | Diagnose |
|---|---|---|---|---|---|
| Fehler | ✅ | ✅ | ✅ | ✅ | ✅ |
| Warnungen | ✅ | ✅ | ✅ | ✅ | ✅ |
| Nachrichten mit hoher Priorität | ✅ | ✅ | ✅ | ✅ | |
| Nachrichten mit normaler Priorität | ✅ | ✅ | ✅ | ||
| Nachrichten mit niedriger Priorität | ✅ | ✅ | |||
| Zusätzliche Informationen zur MSBuild-Engine | ✅ |
Sie können den Schalter -fileLogger (fl) verwenden, um Builddaten in einer Datei zu speichern. Im folgenden Beispiel werden die Builddaten in einer Datei mit dem Namen msbuild.log gespeichert.
msbuild MyProject.proj -t:go -fileLogger
Im folgenden Beispiel heißt die Protokolldatei MyProjectOutput.log, und der Ausführlichkeitsgrad der Protokollausgabe ist auf diagnostic festgelegt. Geben Sie diese beiden Einstellungen mithilfe des Schalters -fileLoggerParameters (flp) an.
msbuild MyProject.proj -t:go -fl -flp:logfile=MyProjectOutput.log;verbosity=diagnostic
Weitere Informationen finden Sie unter Befehlszeilenreferenz.
Im folgenden Beispiel wird das gesamte Protokoll in msbuild1.log, nur die Fehler in JustErrors.log und nur die Warnungen in JustWarnings.log gespeichert. Im Beispiel werden Dateinummern für jede der drei Dateien verwendet. Die Dateinummern werden nach den Schaltern -fl und -flp angegeben (z. B. -fl1 und -flp1).
Die Schalter -fileLoggerParameters (flp) für die Dateien 2 und 3 gibt an, wie jede Datei benannt werden und was sie enthalten soll. Es wird kein Name für die Datei 1 angegeben, deshalb wird der Standardname msbuild1.log verwendet.
msbuild MyProject.proj -t:go -fl1 -fl2 -fl3 -flp2:logfile=JustErrors.log;errorsonly -flp3:logfile=JustWarnings.log;warningsonly
Wenn Sie eine Shell verwenden, die Semikolons interpretiert (z. B. Bash), setzen Sie jede Option, die Semikolons enthält, in einfache oder doppelte Anführungszeichen, um eine Interpretation als Befehlstrennzeichen zu verhindern. Weitere Informationen finden Sie unter Befehlszeilenreferenz.
Sie können das Protokoll mit dem Parameter -binaryLogger (bl) in einem komprimierten, binären Format speichern. Dieses Protokoll enthält eine ausführliche Beschreibung vom Buildprozess und kann mithilfe von bestimmten Protokollanalysetools gelesen werden.
Im folgenden Beispiel wird eine binäre Protokolldatei mit dem Namen binarylogfilename erstellt.
-bl:binarylogfilename.binlog
Sie können die Anzeige für strukturierte Protokolle verwenden, um binäre Protokolle so anzuzeigen, dass sich die Situation viel einfacher beobachten lässt.
Weitere Informationen finden Sie unter Befehlszeilenreferenz.
Sie können eine eigene Protokollierung schreiben, indem Sie einen verwalteten Typ erstellen, der die ILogger-Schnittstelle implementiert. Sie können eine benutzerdefinierte Protokollierung verwenden, um z. B. Buildfehler per E-Mail zu versenden oder sie in einer Datenbank oder in einer XML-Datei zu protokollieren. Weitere Informationen finden Sie unter Buildprotokollierungen.
In der MSBuild-Befehlszeile geben Sie die benutzerdefinierte Protokollierung mithilfe des Schalters -logger an. Sie können auch den Schalter -noconsolelogger verwenden, um die Standardkonsole zu deaktivieren.
Training
Lernpfad
Erstellen von Anwendungen mit dem Azure DevOps-Lernpfad - Training
In diesem Lernpfad erfahren Sie, wie Sie mit anderen Benutzern zusammenarbeiten können, um Ihre Anwendungen mithilfe von Azure Pipelines und GitHub kontinuierlich zu erstellen, zu testen und zu überprüfen.
Dokumentation
Behandeln von MSBuild-Problemen und Erstellen von Protokollen - Visual Studio (Windows)
Hier erfahren Sie, wie Sie Buildprobleme in Ihrem Visual Studio-Projekt diagnostizieren und ggf. ein Protokoll erstellen können, das zur Untersuchung an Microsoft gesendet wird.
Bereinigen eines Builds mit MSBuild - MSBuild
Verwenden Sie MSBuild zum Bereinigen eines Builds, wobei alle Zwischen- und Ausgabedateien gelöscht werden, sodass nur die Projekt- und Komponentendateien beibehalten werden.
MSBuild-Command-Line Referenz - MSBuild
Erfahren Sie, wie Sie MSBuild.exe Befehlszeile verwenden, um eine Projekt- oder Lösungsdatei zu erstellen, und mehrere Optionen, die Sie einschließen können.