Поделиться через

Справочник по командной строке MSBuild

  • Статья

При использовании для построения приложения MSBuild.exe файл проекта или решения можно включить несколько параметров для определения различных аспектов процесса.

MSBuild.exe [Switches] [ProjectFile]

Аргументы

Аргумент

Описание

ProjectFile

Создает целевые объекты в файле проекта, который необходимо задать.Если не указать файл проекта, MSBuild выполняет текущую рабочую папку для расширения имени файла, который завершается в "proj" и используют этот файл.Можно также указать файл решения Visual Studio для этого аргумента.

Переключатели

Параметр

Краткая форма

Описание

/help

/?или /h

Данные потребления отображения.Пример следующую команду:

msbuild.exe /?

/detailedsummary

/ds

Показать подробные сведения в конце журнала построения о конфигурациях, созданные и как они были предназначены к узлу.

/ignoreprojectextensions: extensions

/ignore: extensions

Не учитывать определенные расширения, указав файл проекта, который следует построить.Используйте точку с запятой или запятую, чтобы выделить несколько расширений, как показано в следующем примере:

/ignoreprojectextensions:.vcproj,.sln

/maxcpucount [:number]

/m [:number]

Максимальное количество параллельных процессов для использования при построении.Если не включить этот параметр, то используется значение по умолчанию 1.При включении этого параметра без указания значения, MSBuild будет использовать до количества процессоров в компьютере.Для получения дополнительной информации см. Параллельное построение нескольких проектов с помощью MSBuild.

Следующий пример сообщает MSBuild для построения с помощью MSBuild 3 процесса, который позволяет 3 проекта построения одновременно.

msbuild myproject.proj /maxcpucount:3

/noautoresponse

/noautorsp

Не указывайте никаких файлов MSBuild.rsp автоматически.

/nodeReuse:value

/nr:value

Включите или отключите использовать узлов MSBuild.Можно указать следующие значения.

  • True.Узлы остаются после окончания построения, чтобы последующие построения могли использовать их (по умолчанию).

  • False.Узлы не остаются после завершения построения.

Узел соответствует в проект, который будет выполняться.Если включить параметр /maxcpucount, то нескольких узлов могут выполняться одновременно.

/nologo

Не отображать запуска заголовок или сообщение уведомления об авторских правах.

/preprocess [:filepath]

/pp [:filepath]

Создать один файл проекта, вычисляемые следуют принудительно все файлы, которые будут импортированы во время построения, с их как границы.Можно использовать этот параметр в проще импортировать, определяет, какие файлы, из которого импортировать файлы и файлы, которые участвуют в построение.При использовании этого параметра, проект не будет построен.

Если задано значение filepath, вычисляемые файл проекта извлекаются данные в файл.В противном случае результат отображается в окне консоли.

Дополнительные сведения о том, как использовать элемент Import для вставки файл проекта в другой файл проекта см. в разделах Элемент Import (MSBuild) и Как использовать одинаковый целевой объект в нескольких файлах проектов.

/property:name=value

/p:name=value

Набор или переопределяет определенные свойства уровня проекта, где name - это имя свойства и значение свойства value.Определите каждое свойство отдельно, или используйте точку с запятой или запятую для отделения нескольких свойств, как показано в следующем примере:

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

/target:targets

/t:targets

Построение определенных целевых объектов в проекте.Укажите каждый целевой объект отдельно, или используйте точку с запятой или запятую для отделения нескольких целевых объектов, как показано в следующем примере:

/target:Resources;Compile

Если необходимо задать все целевые объекты с помощью этого переключателя, они выполняются вместо всех целевых объектов в атрибуте DefaultTargets в файле проекта.Дополнительные сведения см. в разделах Порядок построения целевого объекта и Практическое руководство. Выбор цели для первого построения.

Целевой объект команда в составе задачи.Дополнительные сведения см. в разделе Цели MSBuild.

/toolsversion:version

/tv:version

Задает версию набора инструментов для использования построения проекта, как показано в следующем примере: /toolsversion:3.5

С помощью этого переключателя, можно выполнить построение проекта и указать версию, которая отличается от версии, которая определена в Элемент Project (MSBuild).Дополнительные сведения см. в разделе Переопределение параметров ToolsVersion.

В MSBuild 4,5 можно задать следующие значения для version. 2.0, 3.5 и 4.0.При указании значения 4.0, то свойство построения, часть VisualStudioVersion определяет набор инструментов, который следует использовать.Дополнительные сведения см. в разделе Набор инструментов MSBuild (ToolsVersion) вложенного набора инструментов.

Набор инструментов состоит из задач, целевых объектов и средств, используемых для построения приложения.Средства включают пакет как csc.exe и vbc.exe.Дополнительные сведения о наборах инструментов см. в разделах Набор инструментов MSBuild (ToolsVersion), Стандартные и настраиваемые конфигурации наборов инструментов и MSBuild: обзор настройки для различных версий.

ПримечаниеПримечание
Версия набора инструментов отличается от требуемой версии .NET Framework, которая версии платформы .NET Framework, на котором выполняется построение проекта щелкните.Для получения дополнительной информации см. MSBuild: целевая рабочая среда и целевая платформа.

/validate: [schema]

/val [schema]

Проверьте файл проекта и, если проверка завершается успешно, выполните построение проекта.

Если не задать schema, проект возвращен от схемы по умолчанию.

Если задано значение schema, то проект возвращен относительно схемы указанной.

В следующем примере параметр: /validate:MyExtendedBuildSchema.xsd

/verbosity:level

/v:level

Определяет объем сведений для отображения в журнал построения.Каждое средство ведения журнала отображаются события, основанный на уровне детализации, заданные для ведения журнала.

Можно указать следующие уровни детализации. q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic].

В следующем примере параметр: /verbosity:quiet

/version

/ver

Отображаются только сведения о версии.Проект не будет построен.

@file

Вставьте параметры командной строки из текстового файла.Если имеется несколько файлов, нужно указать их по отдельности.Для получения дополнительной информации см. Файлы ответов MSBuild.

ms164311.collapse_all(ru-ru,VS.110).gifПараметры для ведений журнала

Параметр

Краткая форма

Описание

/consoleloggerparameters:parameters

/clp:parameters

Передайте параметры, указанные в средство ведения журнала консоли, в котором отображаются сведения о построении в окне консоли.Можно указать следующие параметры:

  • PerformanceSummary.Укажите время, затраченное на выполнение в задачах, целевых объектов и проектах.

  • Сводка.Отображает ошибку и предупреждение сводку в конце.

  • NoSummary.Не отображать ошибку и предупреждение сводку в конце.

  • ErrorsOnly.Отображает только ошибки.

  • WarningsOnly.Показывает только предупреждения.

  • NoItemAndPropertyList.Не отображать список элементов и свойств, будут отображены в начале каждого построения проекта, если уровень детализации задается значение diagnostic.

  • ShowCommandLine.Отображает сообщения TaskCommandLineEvent.

  • ShowTimestamp.Отображение отметку времени в качестве префикса к любому сообщению.

  • ShowEventId.Отображает идентификатор события для каждого запущенного события, готового события и сообщения.

  • ForceNoAlign.Не рекомендуется выравнивать текста к размеру буфера консоли.

  • DisableConsoleColor.Используйте цвета консоли для всех сообщений ведения журнала.

  • DisableMPLogging.Отключение стиль ведения журналов в многопроцессорной среде, работающих в режиме без вывода в многопроцессорной среде.

  • EnableMPLogging.Включите стиль ведения журналов в многопроцессорной среде даже при выполнении в режиме, в многопроцессорной среде.Этот стиль ведения журнала включен по умолчанию.

  • Детализация.Переопределите параметр /verbosity для данного средства ведения журнала.

Используйте точку с запятой или запятую, чтобы выделить несколько параметров, как показано в следующем примере:

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

/distributedFileLogger

/dfl

Записывать выходные данные построения в журнал каждого узла MSBuild к собственному файл.Исходным местоположением данных файлов является текущий каталог.По умолчанию файлы называются MSBuild NodeId.log".Можно использовать параметр /fileLoggerParameters для задания местоположения файлов и других параметров для fileLogger.

Если выбрать файл журнала с помощью ключа /fileLoggerParameters, распределянное ведение журнала будет использовать его имя в качестве шаблона и будет добавлен идентификатор узла к этому имени создание файла журнала для каждого узла.

/distributedlogger:central loggerforwarding logger*

/dl:central loggerforwarding logger*

События из журнала MSBuild, вложа другой экземпляр средства ведения журнала к каждому узлу.Если требуется использовать несколько средств ведения журнала, каждое из них необходимо указать отдельно.

Используется синтаксис ведения журнала для идентификации ведение журнала.Синтаксис ведения журнала см. в параметр /logger.

В следующем примере показано, как использовать этот параметр:

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

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

/fileLogger [номер]

/fl [number]

Записывать выходные данные построения в отдельный файл в текущем каталоге.Если не задать number, выходной файл называется msbuild.log.Если задано значение number, то выходной файл называется n msbuild .log, где n number.Number может быть цифры от 1 до 9.

Можно использовать параметр /fileLoggerParameters для задания местоположения файла и других параметров для fileLogger.

/fileloggerparameters: [номер] parameters

/flp: [ numberparameters]

Определяет все дополнительные параметры для ведения журнала в файле и распределянного ведения журнала в файле.Наличие данного переключателя означает, что совпадать и переключатель filelogger[number].Number может быть цифры от 1 до 9.

Можно использовать любые параметры, указанные для /consoleloggerparameters.Также можно использовать один или несколько следующих параметров:

  • Файл регистрации.Путь к файлу журнала, в который записывается в журнал построения.Распределенные префиксы ведения журнала в файле этот путь к именам его файла журнала.

  • Добавление.Определяет, добавлен ли в журнале построения в файл журнала или перезапишет его.Если этот переключатель установлен, журнал построения присоединяется в конец файла журнала.Если не задать ключ, перезаписываются содержимое существующего файла журнала.

  • Кодировка.Определяет кодирование для файла (например, UTF-8, юникод или 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

/l:logger

Задает средство ведения журнала, которое следует использовать для протоколирования событий от MSBuild.Если требуется использовать несколько средств ведения журнала, каждое из них необходимо указать отдельно.

Используйте следующий синтаксис: 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

/noconsolelogger

/noconlog

Отключите ведения журнала консоли, а не записывать в журнал события на консоль.

Пример

В следующем примере производится построение цели rebuild проекта MyProject.proj.

MSBuild.exe MyProject.proj /t:rebuild

Программу MSBuild.exe можно использовать и для выполнения более сложного построения.Например, с ее помощью можно построить конкретные цели тех или иных проектов в решении.Следующие примеры перестроения проекта NotInSolutionFolder и InSolutionFolder, чтобы построить проект, в папке решения NewFolder.

msbuild SlnFolders.sln /t:NotInSolutionfolder:Rebuild;NewFolder\InSolutionFolder:Clean

См. также

Ссылки

Общие свойства проектов MSBuild

Другие ресурсы

Справочные сведения о MSBuild