Referência de linha de comando do MSBuild
MSBuild.exe constrói o projeto especificado ou o arquivo de 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, MSBuildpesquisa no diretório de trabalho corrente 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 direitos autorais. |
/versão |
Exibe somente as 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 auto-inclui o arquivo MSBuild.rsp. /noautorsp também é aceitável. |
/ destino: targets |
Compila esses destinos neste projeto. Use um ponto-e-vírgula ou vírgula para separar vários destinos ou especifique cada destino separadamente. /t também é aceitável. Por exemplo: /target:Resources;Compile |
/propriedade: name=value |
Define ou substitui essas propriedades em nível de projeto, onde name é o nome da propriedade e value é o valor da propriedade. Use um ponto-e-vírgula ou 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 |
/agente: logger |
Especifica o agente de log para usar para registrar eventos do MSBuild. Para especificar vários agentes de log, especifique cada agente de log separadamente. A sintaxe de agente de log é: [LoggerClass,]LoggerAssembly[;LoggerParameters] The LoggerClass a sintaxe é: [PartialOrFullNamespace.]LoggerClassName .gif "Observação") Observação:
Não é necessário especificar a classe de agente de log se houver exatamente um agente de log no assembly.
The LoggerAssembly a sintaxe é: {AssemblyName[,StrongName] | AssemblyFile} Parâmetros do agente de log são opcionais e são passados para o agente de log exatamente sistema autônomo você sistema autônomo digita. Por exemplo: /logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML |
/distributedlogger: < central logger > * < agente de log de encaminhamento > |
Use este agente de log para efetuar logon eventos do MSBuild. Para especificar vários agentes de log, especifique cada agente de log separadamente. (Curta formulário /dl) A sintaxe <agente>é: [< logger classe >,] < assembly de agente de log > [; < parâmetros do agente de log >] A sintaxe < @@ > é: [< parcial ou plena namespace >.]<nome de classe agente > A sintaxe < assembly de agente de log > é: {<nome do assembly > [, < nome forte >] | < arquivo do assembly >} sistema autônomo parâmetros de agente de log < > são opcionais e são passados para o agente de log exatamente sistema autônomo digitada-los. (Forma abreviada: l) /. Exemplos: /DL:XMLLogger,MyLogger,versão=1.0.2,cultura=neutral /DL:MyLogger,C:\My.dll*ForwardingLogger,C:\agente.dll |
/consoleLoggerParameters: parameters |
Especifica os parâmetros para passar para o agente de log de console. /CLP também é aceitável. sistema autônomo parâmetros disponível são:
|
/verbosity: level |
Essa quantidade de informações no log de compilação. Loggers individuais exibem eventos com base no nível de verbosidade. Um agente de log também pode ser configurado para ignorar a configuração de nível de detalhes. Os níveis de verbosidade disponível 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. |
/ validar: schema |
Valide o arquivo de projeto e, se a validação tiver êxito, constrói o projeto. If schema não for especificado, valida o projeto contra o esquema padrão. If schema for especificado, valida o projeto contra o esquema especificado. |
/maxcpucount: number |
Especifica o número de processos do operador que estão envolvidas na compilação. Por exemplo: C:\Windows\WinFX\v3.5>msbuild.exe *.proj /maxcpucount:3. Este exemplo instrui o MS compilação para compilação usando MScompilação.exe três processos, permitindo que três projetos para compilação em paralelo. /m também é aceitável. |
/ignoreprojectextensions: <extensions> |
Lista de extensões para ignorar quando o arquivo de projeto para compilação está sendo determinados. Use um ponto-e-vírgula ou 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 corrente. A localização do arquivo e outros parâmetros do fileLogger podem ser especificados por meio da adição do "/ fileLoggerParameters" comutador. (Forma abreviada: / fl) |
/distributedFileLogger |
Registra a saída de compilação para vários arquivos de log, um arquivo de log por nó do MSBuild. O local inicial desses arquivos é o diretório corrente. Por padrão, os arquivos são chamados "MSBuild <nodeid>.log". O local dos arquivos e outros parâmetros do fileLogger pode ser especificado com a adição do "/ fileLoggerParameters" comutador. Se um nome de arquivo de log for conjunto pelo comutador fileLoggerParameters o agente de log distribuído usará o fileName sistema autônomo um modelo e acrescentar a ID de nó a este fileName 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) Os parâmetros disponível são: LogFile - O caminho para o arquivo de log no qual o log de compilação será gravado. O agente de log de arquivos distribuídos usa isso sistema autônomo um prefixo para seus nomes de arquivo de log. acrescentar - determina se o log de compilação será anexado ao ou substituir o arquivo de log. Quando você conjunto comutador, o log de compilação é anexado ao arquivo de log. Quando comutador não for definida, o Sumário de um arquivo de log existentes é sobrescrito. O padrão é não acrescentar ao arquivo de log. Detalhamento - substitui a configuração de nível de detalhes padrão do detalhadas. A codificação - Especifica a codificação do arquivo, por exemplo, UTF-8. Qualquer um dos parâmetros do agente de log de console também pode ser usado. 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 compilação o projeto. Esse comando permite criar um projeto, usando uma versão diferente do especificado no Elemento do projeto (MSBuild). Por exemplo: C:\Windows\WinFX\v3.5>msbuild.exe *.proj /ToolsVersion:3.5 /p:Configuration=Debug Valores válido para version são sistema autônomo seguintes: 2,0, 3,0 e 3,5. Para obter mais informações sobre conjuntos de ferramentas, consulte Criando para específicos .NET Frameworks. |
/nodeReuse: <parameters> |
Ativa ou desativa a reutilização de nós do MSBuild. Os parâmetros são: True - nós permanecem após a compilação é concluída e 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 desativá-lo com /noconsolelogger e, em seguida, especifique-a com o /logger sintaxe. Por exemplo, use a seguinte linha de comando para mostrar o desempenho resumo normalmente exibida somente no nível de detalhes de diagnóstico:
msbuild myproject.csproj /noconsolelogger /l:ConsoleLogger,Microsoft.Build.Engine.dll;performancesummary
Exemplo
O exemplo a seguir cria o rebuild destino das MyProject.proj projeto.
MSBuild.exe MyProject.proj /t:rebuild
Você pode usar o MSBuild.exe executar compilações mais complexas. Por exemplo, poder usá-lo 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á na NewFolder pasta de solução.
msbuild SlnFolders.sln /t:NotInSolutionfolder:Rebuild;NewFolder\InSolutionFolder:Clean