Microsoft (R)-Buildmodul, Version 3.5.30729.1
[Microsoft .NET Framework, Version 2.0.50727.3603]
Copyright (C) Microsoft Corporation 2007. Alle Rechte vorbehalten.
Syntax: MSBuild.exe [Optionen] [Projektdatei]
Beschreibung: Erstellt die angegebenen Ziele in der Projektdatei. Wenn
keine Projektdatei angegeben ist, wird das aktuelle Arbeitsverzeichnis
von MSBuild nach einer Datei durchsucht, die eine Dateierweiterung
besitzt, die auf "proj" endet. Diese Datei wird dann verwendet.
Schalter:
/target:<Ziele> Erstellt diese Ziele in diesem Projekt. Mehrere Ziele werden durch ein Semikolon
oder Komma voneinander getrennt. Alternativ kann jedes Ziel gesondert
angegeben werden. (Kurzform: /t)
Beispiel:
/target:Resources;Compile
/property:<n>=<v> Legt diese Eigenschaften auf Projektebene fest oder berschreibt sie. <n> ist
der Eigenschaftenname, und <v> ist der Eigenschaftenwert. Mehrere
Eigenschaften werden durch ein Semikolon oder Komma getrennt.
Alternativ kann jede Eigenschaft gesondert angegeben werden. (Kurzform: /p)
Beispiel:
/property:WarningLevel=2;OutDir=bin\Debug\
/maxcpucount:[n] Gibt die maximale Anzahl gleichzeitiger Prozesse an,
mit denen die Erstellung ausgefhrt werden soll. Ohne den
Schalter wird der Standardwert 1 verwendet. Wenn der Schalter
ohne einen Wert angegeben wird, verwendet MSBuild alle
Prozessoren des Computers. (Kurzform: /m[:n])
/toolsversion:<Version>
Die Version des MSBuild-Toolsets (Aufgaben, Ziele usw.),
die w„hrend des Erstellens zu verwenden ist. Diese Version berschreibt die
von einzelnen Projekten angegebenen Versionen. (Kurzform:
/tv)
Beispiel:
/toolsversion:3.5
/verbosity:<Grad> Zeigt diesen Grad von Informationen im Ereignisprotokoll an.
Folgende Ausfhrlichkeitsgrade sind verfgbar: q[uiet], m[inimal],
n[ormal], d[etailed] und diag[nostic]. (Kurzform: /v)
Beispiel:
/verbosity:quiet
/consoleloggerparameters:<Parameter>
Parameter fr die Konsolenprotokollierung. (Kurzform: /clp)
Folgende Parameter sind verfgbar:
PerformanceSummary - Zeigt die in Aufgaben, Zielen und
Projekten verbrachte Zeit an.
Summary - Zeigt abschlieáend eine Zusammenfassung der Fehler
und Warnungen an.
NoSummary - Zeigt keine Fehler- und Warnungsbersicht am
Ende an.
ErrorsOnly - Zeigt nur Fehler an..
WarningsOnly - Zeigt nur Warnungen an.
NoItemAndPropertyList - Zeigt keine Liste der Elemente
und Eigenschaften am Anfang jeder Projekterstellung
an.
ShowCommandLine - Zeigt TaskCommandLineEvent-Meldungen
an.
ShowTimestamp - Zeigt den Timestamp als Pr„fix einer
Meldung an.
ShowEventId - Zeigt die eventId fr gestartete
Ereignisse, abgeschlossene Ereignisse und Meldungen
an.
ForceNoAlign - Richtet den Text nicht n der GrӇe des
Konsolenpuffers aus.
DisableMPLogging - Deaktiviert die Ausgabe wie
bei der Mehrprozessorprotokollierung im Modus
mit nur einem Prozessor.
EnableMPLogging - Aktiviert das Format der
Mehrprozessorprotokollierung auch bei der Ausfhrung
im Modus mit nur einem Prozessor. Dieses
Protokollierungsformat ist standardm„áig aktiviert.
Verbosity - šberschreibt die Einstellung fr /verbosity fr
diese Protokollierung.
Beispiel:
/consoleloggerparameters:PerformanceSummary;NoSummary;
Verbosity=minimal
/noconsolelogger Deaktiviert die Standardkonsolenprotokollierung und protokolliert keine Ereignisse
auf der Konsole. (Kurzform: /noconlog)
/fileLogger[n] Protokolliert die Erstellungsausgabe in eine Datei.
Standardm„áig befindet sich diese im aktuellen Verzeichnis, der
Dateiname lautet "msbuild[n].log". Ereignisse aller Knoten
werden in einem einzigen Protokoll zusammengefasst. Der
Speicherort der Datei und andere Parameter fr fileLogger
k”nnen durch das Hinzufgen
des Schalters
"/fileLoggerParameters[n]" angegeben werden.
"n" (optional) kann eine Zahl von 1-9 sein, sodass bis zu
10 Dateiprotokollierungen angefgt werden k”nnen.
(Kurzform: /fl[n])
/fileloggerparameters[n]:<Parameter>
Gibt zus„tzliche Parameter fr Dateiprotokollierungen an.
Dieser Schalter bedeutet, dass der entsprechende
Schalter "/filelogger[n]" ebenfalls vorhanden ist.
"n" (optional) kann eine Zahl von 1-9 sein.
"/fileloggerparameters" wird auch von verteilten
Dateiprotokollierungen verwendet (siehe Beschreibung
zu "/distributedFileLogger").
(Kurzform: /flp[n])
Es sind dieselben Parameter wie fr die Konsolenprotokollierung
verfgbar. Einige zus„tzliche Parameter:
LogFile - Pfad der Protokolldatei, in die das
Buildprotokoll geschrieben wird.
Append - Gibt an, ob das Buildprotokoll erweitert oder
oder berschrieben wird. Mit diesem Schalter
wird das Buildprotokoll an die Protokolldatei angefgt;
Ohne diesen Schalter wird der Inhalt
der vorhandenen Protokolldatei berschrieben.
Standardm„áig wird die Protokolldatei nicht erweitert.
Encoding - Gibt die Codierung der Datei an,
z.B. UTF-8, Unicode oder ASCII.
Die Standardeinstellung fr "verbosity" ist "Detailed".
Beispiele:
/fileLoggerParameters:LogFile=MyLog.log;Append;
Verbosity=diagnostic;Encoding=UTF-8
/flp:Summary;Verbosity=minimal;LogFile=msbuild.sum
/flp1:warningsonly;logfile=msbuild.wrn
/flp2:errorsonly;logfile=msbuild.err
/distributedlogger:<Zentrale Protokollierung>*<Weiterleitende
Protokollierung>
Mithilfe dieser Protokollierung werden Ereignisse von MSBuild
protokolliert, wobei an jeden Knoten eine andere
Protokollierungsinstanz angefgt wird. Um mehrere
Protokollierungen anzugeben, wird jede Protokollierung
gesondert angegeben.
(Kurzform /dl)
Die Syntax fr die <Protokollierung> lautet:
[<Protokollierungsklasse>,]<Protokollierungsassembly>
[;<Protokollierungsparameter>]
Die Syntax fr die <Protokollierungsklasse> lautet:
[<Teilweiser oder vollst„ndiger Namespace>.]<Name der
Protokollierungsklasse>
Die Syntax fr die <Protokollierungsassembly> lautet:
{<Assemblyname>[,<Starker Name>] | <Assemblydatei>}
Die <Protokollierungsparameter> sind optional und werden genau
so an die Protokollierung bergeben, wie sie eingegeben wurden.
(Kurzform: /l)
Beispiele:
/dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral
/dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll
/distributedFileLogger
Protokolliert die Erstellungsausgabe in mehrere Dateien, eine Protokolldatei
pro MSBuild-Knoten. Der anf„ngliche Speicherort fr diese Dateien ist
das aktuelle Verzeichnis. Standardm„áig werden die Dateien
"MSBuild<Knoten-ID>.log" benannt. Der Speicherort der Datei und
andere Parameter fr fileLogger k”nnen durch das Hinzufgen
des Schalters "/fileLoggerParameters" angegeben werden.
Wenn mithilfe des fileLoggerParameters-Parameters ein Protokolldateiname festgelegt wurde,
verwendet die verteilte Protokollierung den Dateinamen als
Vorlage und fgt die Knoten-ID an diesen Dateinamen an,
um fr jeden Knoten eine Protokolldatei zu erstellen.
/logger:<Protokollierung> Mithilfe dieser Protokollierung werden Ereignisse von
MSBuild protokolliert. Um mehrere Protokollierungen anzugeben,
wird jede Protokollierung gesondert angegeben.
Die Syntax fr die <Protokollierung> lautet:
[<Protokollierungsklasse>,]<Protokollierungsassembly>[;<Protokollierungsparameter>]
Die Syntax fr die <Protokollierungsklasse> lautet:
[<Teilweiser oder vollst„ndiger Namespace>.]<Name der
Protokollierungsklasse>
Die Syntax fr die <Protokollierungsassembly> lautet:
{<Assemblyname>[,<Starker Name>] | <Assemblydatei>}
Die <Protokollierungsparameter> sind optional und werden genau
so an die Protokollierung bergeben, wie sie eingegeben wurden.
(Kurzform: /l)
Beispiele:
/logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral
/logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML
/validate šberprft das Projekt anhand des Standardschemas. (Kurz-
form: /val)
/validate:<Schema> šberprft das Projekt anhand des angegebenen Schemas. (Kurz-
form: /val)
Beispiel:
/validate:MyExtendedBuildSchema.xsd
/ignoreprojectextensions:<Erweiterungen>
Liste der zu ignorierenden Erweiterungen, wenn die zu erstellende
Projektdatei ermittelt wird. Verwenden Sie ein Semikolon oder ein Komma,
um mehrere Erweiterungen voneinander zu trennen.
(Kurzform: /ignore)
Beispiel:
/ignoreprojectextensions:.vcproj,.sln
/nodeReuse:<Parameter>
Aktiviert oder deaktiviert die Wiederverwendung von
MSBuild-Knoten.
Die Parameter lauten:
True - Knoten bleiben nach dem Abschluss der Erstellung
erhalten und werden bei folgenden Erstellungen wiederverwendet
(Standardeinstellung).
False - Knoten bleiben nach dem Abschluss der Erstellung
nicht erhalten.
(Kurzform: /nr)
Beispiel:
/nr:true
@<Datei> Fgt Befehlszeileneinstellungen aus einer Textdatei ein. Um mehrere
Antwortdateien anzugeben, geben Sie jede Antwortdatei
gesondert an.
/noautoresponse Schlieát die Datei "MSBuild.rsp" nicht automatisch ein. (Kurzform:
/noautorsp)
/nologo Zeigt kein Startbanner und keine Copyrightmeldung an.
/version Zeigt nur Versionsinformationen an. (Kurzform: /ver)
/help Zeigt diese Syntaxmeldung an. (Kurzform: /? oder /h)
Beispiele:
MSBuild MyApp.sln /t:Rebuild /p:Configuration=Release
MSBuild MyApp.csproj /t:Clean
/p:Configuration=Debug;TargetFrameworkVersion=v3.5
