Referência de linha de comando do MSBuild
MSBuild. exe cria o arquivo especificado de projeto ou solução, com as opções especificadas.
MSBuild.exe [Switches] [ProjectFile]
Argumentos
Argumento |
Descrição |
|---|---|
ProjectFile |
Compila os destinos especificados no arquivo de projeto. Se um arquivo de projeto não for especificado, MSBuild procura no diretório de trabalho atual para uma extensão de nome de arquivo que termina em "proj" e usa esse arquivo. Este argumento também aceita Visual Studio 2005 arquivos de solução. |
Switches
Switch |
Descrição |
|---|---|
/help |
Exibe informações de uso. /? ou /h também são aceitáveis. Por exemplo: Msbuild.exe /? |
/nologo |
Oculta a faixa de inicialização e mensagem de copyright. |
/Version |
Exibe apenas informações de versão. /ver também é aceitável. |
@file |
Insere as configurações de linha de comando de um arquivo de texto. Especifique cada arquivo de resposta separadamente. Para obter mais informações, consulte Arquivos de resposta do MSBuild. |
/noautoresponse |
Não inclua o arquivo MSBuild. /noautorsp também é aceitável. |
/Target:targets |
Compila esses destinos neste projeto. Use um ponto e vírgula ou uma vírgula para separar vários destinos ou especifique cada destino separadamente. /t também seja aceitável. Por exemplo: /target:Resources;Compile |
/Property:name=value |
Define ou substitui essas propriedades no nível do projeto, onde name é o nome de propriedade e value é o valor da propriedade. Use um ponto e vírgula ou uma vírgula para separar várias propriedades ou especifique cada propriedade separadamente. /p também é aceitável. Por exemplo: /property:WarningLevel=2;OutputDir=bin\Debug |
/logger:logger |
Especifica o agente de log para usar o log de eventos do MSBuild. Para especificar vários agentes de log, especifique cada agente de log separadamente. A sintaxe do agente de log é: [LoggerClass,]LoggerAssembly[;LoggerParameters] O LoggerClass sintaxe é: [PartialOrFullNamespace.]LoggerClassName Observação Não é necessário especificar a classe logger, se houver exatamente um agente de log no assembly. O LoggerAssembly sintaxe é: {AssemblyName[,StrongName] | AssemblyFile} Parâmetros do agente de log são opcionais e são passados para o agente de log exatamente como você as digita. Por exemplo: /logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML |
/distributedlogger: < central logger > * < encaminhamento logger > |
Use este agente de log para registrar eventos do MSBuild. Para especificar vários agentes de log, especifique cada agente de log separadamente. (Forma abreviada /dl) <logger> a sintaxe é: [< logger classe >] < assembly do agente de log > [; < parâmetros do agente de log >] A classe < logger > a sintaxe é: [< parcial ou total namespace >.]< nome da classe logger > O < assembly > a sintaxe é: {< assembly name > [, < nome de alta segurança >] | < arquivo de assembly >} < parâmetros do agente de log > são opcionais e são passaram para o agente de log exatamente como você as digitou. (Forma abreviada: / l). Exemplos: /DL:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral /DL:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll |
/consoleLoggerParameters:parameters |
Especifica os parâmetros para passar para o agente de log do console. /CLP também é aceitável. Os parâmetros disponíveis são:
|
/verbosity:level |
Exibe o volume de informações no log de compilação. Loggers individuais exibem eventos com base em nível de verbosidade. Um agente de log também pode ser configurado para ignorar a configuração de verbosidade. Os níveis de verbosidade disponíveis são q[uiet], m[inimal], n[ormal], d[etailed], e diag[nostic]. /v também é aceitável. Por exemplo: /verbosity:quiet |
/noconsolelogger |
Desativa o agente de log de console padrão e não registra eventos no console. /noconlog também é aceitável. |
/Validate:schema |
Valida o arquivo de projeto e, se a validação for bem-sucedida, cria o projeto. Se schema não for especificado, valida o projeto contra o esquema padrão. Se schema for especificado, valida o projeto contra o esquema especificado. |
/maxcpucount:number |
Especifica o número de processos de trabalho que estão envolvidas na compilação. Por exemplo: C:\Windows\WinFX\v3.5[]msbuild.exe *.proj /maxcpucount:3. Este exemplo instrui o MSBuild para construir usando três processos MSBuild. exe, permitindo assim que os três projetos criar em paralelo. /m também é aceitável. |
/ignoreprojectextensions: <extensions> |
Lista de extensões para ignorar quando o arquivo de projeto para criar está sendo determinado. Use um ponto e vírgula ou uma vírgula para separar várias extensões. (Forma abreviada: / Ignorar) exemplo: /ignoreprojectextensions:.vcproj,.sln |
/fileLogger |
Registra a compilação de saída para um único arquivo ("msbuild.log") no diretório atual. O local do arquivo e outros parâmetros para fileLogger pode ser especificado por meio da adição do "/ /fileLoggerParameters" switch. (Forma abreviada: / fl) |
/distributedFileLogger |
Registra a saída de compilação em vários arquivos de log, um arquivo de log por nó do MSBuild. A localização inicial desses arquivos é o diretório atual. Por padrão, os arquivos são chamados "MSBuild <nodeid>. log". O local dos arquivos e outros parâmetros para fileLogger pode ser especificado com a adição a "/ /fileLoggerParameters" switch. Se um nome de arquivo de log é conjunto pela opção fileLoggerParameters do agente de log distribuído usará o nome do arquivo como um modelo e acrescentar a identificação de nó para esse nome de arquivo para criar um arquivo de log para cada nó. |
/fileLoggerParameters: <parameters> |
Especifica os parâmetros para o agente de log de arquivo e o agente de log de arquivos distribuídos. (Forma abreviada: / flp) Você pode usar até dez agentes de log de arquivo, seguindo o parâmetro com um dígito, identificando o agente de log. Por exemplo, para gerar arquivos de log separados para erros e avisos, use-/flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly Os parâmetros disponíveis são: Arquivo de log - O caminho para o arquivo de log no qual o log de compilação é gravado. O agente de log de arquivos distribuídos usa isso como um prefixo para nomes de arquivo de log. Append - determina se o log de compilação é acrescentado ao ou sobrescrever o arquivo de log. Quando você definir a opção, o log de compilação é anexado ao arquivo de log. Quando você não define a opção, o conteúdo de um arquivo de log existentes é substituído. O padrão é não anexar ao arquivo de log. Detalhamento - substitui a configuração de verbosidade de padrão de detalhadas. Codificação - Especifica a codificação do arquivo, por exemplo, UTF-8. Também pode ser usado qualquer um dos parâmetros do agente de log de console. Por exemplo: /fileLoggerParameters:LogFile=MyLog.log;Append; Verbosity=diagnostic;Encoding=UTF-8 |
/toolsversion:version |
Especifica a versão do conjunto de ferramentas para usar para construir o projeto. Esse comando permite criar um projeto usando uma versão diferente do especificado na Elemento do projeto (MSBuild). Por exemplo: C:\Windows\WinFX\v3.5[]msbuild.exe *.proj /ToolsVersion:3.5 /p:Configuration=Debug Os valores válidos para version são da seguinte maneira: 2.0, 3.0 e 3.5. Para obter mais informações sobre conjuntos de ferramentas, consulte Criação de versões específicas da.NET <>Framework>. |
/nodeReuse: <parameters> |
Habilita ou desabilita a reutilização de nós do MSBuild. Os parâmetros são: True - nós permanecem após a conclusão de compilação e são reutilizados por compilações subseqüentes. False - nós não permanecem após a conclusão da compilação. (Forma abreviada: / nr) exemplo: /nr:true |
Comentários
Para passar parâmetros para o agente de log de console padrão, primeiro desabilite com /noconsolelogger e, em seguida, especifique-o com o /logger sintaxe. Por exemplo, use a seguinte linha de comando para mostrar o desempenho resumo normalmente exibida apenas no detalhamento de diagnóstico:
msbuild myproject.csproj /noconsolelogger /l:ConsoleLogger,Microsoft.Build.Engine.dll;performancesummary
Exemplo
O exemplo a seguir cria o rebuild o destino da MyProject.proj project.
MSBuild.exe MyProject.proj /t:rebuild
Você pode usar o MSBuild. exe para executar compilações mais complexas. Por exemplo, ele pode usar para criar destinos específicos de projetos específicos em uma solução. O exemplo a seguir recria o projeto NotInSolutionFoldere limpa o projeto InSolutionFolder, que está sendo o NewFolder pasta de solução.
msbuild SlnFolders.sln /t:NotInSolutionfolder:Rebuild;NewFolder\InSolutionFolder:Clean