msbuild.exe /?

/ignoreprojectextensions:.vcproj,.sln

下面的示例指示 MSBuild 使用三个 MSBuild 进程进行生成，这允许同时生成三个项目：

msbuild myproject.proj /maxcpucount:3

• true。 节点在生成完成之后保留，以便后续生成可以使用它们（默认值）。
• false。 节点在生成完成之后不保留。

节点对应于正在执行的项目。 如果包含 /maxcpucount 开关，则多个节点可以并发执行。

如果指定 filepath，则会将聚合项目文件输出到文件。 否则，输出将显示在控制台窗口中。

有关如何使用 Import 元素将项目文件插入到另一个项目文件中的信息，请参阅 Import 元素 (MSBuild) 和How to: Use the Same Target in Multiple Project Files。

/property:WarningLevel=2;OutDir=bin\Debug

/target:Resources;Compile

如果使用此开关指定任何目标，则它们会代替项目文件中的 DefaultTargets 特性中的任何目标来运行。 有关详细信息，请参阅Target Build Order和How To: Specify Which Target to Build First。

目标是一组任务。 有关详细信息，请参阅MSBuild Targets。

使用此开关可以生成项目并指定与 Project 元素 (MSBuild) 中指定的版本不同的版本。 有关详细信息，请参阅Overriding ToolsVersion Settings。

对于 MSBuild 4.5，可以为 version 指定以下值：2.0、3.5 和 4.0。 如果指定 4.0，VisualStudioVersion 生成属性会指定要使用的子工具集。 有关详细信息，请参阅 MSBuild Toolset (ToolsVersion) 的“子工具集”一节。

包含用于生成应用程序的任务、目标和工具的工具集。 工具包括编译器例如 csc.exe 和 vbc.exe。 有关工具集的详细信息，请参阅MSBuild Toolset (ToolsVersion)、Standard and Custom Toolset Configurations和 MSBuild Multitargeting Overview。

 说明

工具集版本与目标框架不同，后者是生成项目以其其上运行的 .NET Framework 的版本。 有关详细信息，请参阅MSBuild Target Framework and Target Platform。

如果没有指定 schema，则针对默认架构验证项目。

如果指定 schema，则针对指定的架构验证项目。

下面的设置是一个示例：/validate:MyExtendedBuildSchema.xsd

可以指定以下详细级别：q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

下面的设置是一个示例：/verbosity:quiet

parameters

• PerformanceSummary。 显示在任务、目标和项目中所花费的时间。
• Summary。 在末尾显示错误和警告摘要。
• NoSummary。 不在末尾显示错误和警告摘要。
• ErrorsOnly。 仅显示错误。
• WarningsOnly。 仅显示警告。
• NoItemAndPropertyList。 如果详细级别设置为 diagnostic，则不在每个项目生成开头显示项和属性的列表。
• ShowCommandLine。 显示 TaskCommandLineEvent 消息。
• ShowTimestamp。 将时间戳显示为任何消息的前缀。
• ShowEventId。 显示每个已启动事件、已完成事件和消息的事件 ID。
• ForceNoAlign。 不将文本与控制台缓冲区大小对齐。
• DisableConsoleColor。 将默认控制台颜色用于所有日志记录消息。
• DisableMPLogging。 在非多处理器模式下运行时，禁用输出的多处理器日志记录样式。
• EnableMPLogging。 启用多处理器日志记录样式（即使在非多处理器模式下运行）。 默认情况下，此日志记录样式处于启用状态。
• Verbosity。 重写此记录器的 /verbosity 设置。

使用分号或逗号分隔多个参数，如以下示例所示：

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

如果使用 /fileLoggerParameters 开关命名日志文件，则分布式记录器会在为每个节点创建日志文件时使用该名称作为模板并将节点 ID 追加到该名称。

central logger*

forwarding logger

使用记录器语法指定记录器。 有关记录器语法，请参阅下面的 /logger 开关。

下面的示例演示如何使用此开关：

/dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll

[number]

可以使用 /fileLoggerParameters 开关指定文件位置和 fileLogger 的其他参数。

parameters

可以使用为 /consoleloggerparameters 列出的所有参数。 还可以使用以下一个或多个参数：

• LogFile。 写入生成日志的日志文件的路径。 分布式文件记录器将此路径用作其日志文件的名称的前缀。
• Append。 确定是将生成日志追加到日志文件还是覆盖它。 设置该开关时，生成日志将追加到日志文件。 此开关不存在时，将覆盖现有日志文件的内容。

  如果包含追加开关，则无论它是设置为 true 还是 false，都会追加日志。 如果不包含追加开关，则会覆盖日志。

  在此例中会覆盖文件：msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log

  在此例中会追加文件：msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=true

  在此例中会追加文件：msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=false

• Encoding。 指定文件的编码（例如，UTF-8、Unicode 或 ASCII）。

下面的示例为警告和错误生成单独的日志文件：

/flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly

下面的示例演示其他可能性：

/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

logger

将以下语法用于 logger：[LoggerClass,]LoggerAssembly[;LoggerParameters]

将以下语法用于 LoggerClass：[PartialOrFullNamespace.]LoggerClassName

如果程序集恰好包含一个记录器，则不必指定记录器类。

将以下语法用于 LoggerAssembly：{AssemblyName[,StrongName] | AssemblyFile}

记录器参数是可选的，传递给记录器时与输入时完全一致。

下面的示例使用 /logger 开关。

/logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML