Compartir a través de


Referencia de la línea de comandos de MSBuild

Si utiliza MSBuild.exe para compilar un proyecto o archivo de solución, puede incluir varios modificadores para especificar distintos aspectos del proceso.

MSBuild.exe [Switches] [ProjectFile]

Argumentos

Argumento

Descripción

ProjectFile

Compila destinos en el archivo de proyecto especificado.Si no especifica un archivo de proyecto, MSBuild busca en el directorio de trabajo actual para una extensión de nombre de archivo que termine en “proj” y utilicen ese archivo.También puede especificar un archivo de solución de Visual Studio para este argumento.

Modificadores

Modificador

Forma abreviada

Descripción

/help

/?o /h

Información de uso de la pantalla.El comando siguiente es un ejemplo:

msbuild.exe /?

/detailedsummary

/ds

Muestra información detallada al final de la compilación registrar sobre las configuraciones que se compilaron y cómo se programados a los nodos.

/ignoreprojectextensions: extensions

/ignore: extensions

Omitir las extensiones especificadas para determinar qué archivo de proyecto a compilar.Utilice un punto y coma o una coma para separar varias extensiones, como se muestra en el ejemplo siguiente:

/ignoreprojectextensions:.vcproj,.sln

/maxcpucount [:number]

/m [:number]

Especifica el número máximo de procesos simultáneos para utilizar al compilar.Si no incluye este modificador, el valor predeterminado es 1.Si incluye este modificador sin especificar un valor, MSBuild utilizará hasta el número de procesadores del equipo.Para obtener más información, vea Compilar varios proyectos en paralelo con MSBuild.

El ejemplo siguiente indica a MSBuild para compilar mediante tres procesos de MSBuild, que permite tres proyectos compilar al mismo tiempo:

msbuild myproject.proj /maxcpucount:3

/noautoresponse

/noautorsp

No incluya ningún archivo de MSBuild.rsp automáticamente.

/nodeReuse:value

/nr:value

Habilitar o deshabilitar la reutilización de los nodos de MSBuild.Puede especificar los siguientes valores:

  • True.Se conservan los nodos cuando finaliza la compilación de modo que las compilaciones subsiguientes pueden utilizarlos (valor predeterminado).

  • False.No se conservan los nodos después de la compilación finalice.

Un nodo corresponde a un proyecto que se está ejecutando.Si incluye el modificador /maxcpucount, múltiples nodos se pueden ejecutar simultáneamente.

/nologo

No muestre la pancarta de inicio o el mensaje de copyright.

/preprocess [:filepath]

/pp [:filepath]

Cree un archivo de proyecto único, agregado inclusión todos los archivos que se importarán durante una compilación, con sus límites marcados.Puede utilizar este modificador con mayor facilidad determina se importa qué archivos, desde la que se están importando los archivos, y de qué archivos contribuyen a la compilación.Cuando usa este modificador, no se compila.

Si especifica filepath, el archivo de proyecto agregado se representa en el archivo.Si no, los resultados aparecen en la ventana de la consola.

Para obtener información sobre cómo utilizar el elemento de Import para incrustar un archivo de proyecto en otro archivo de proyecto, vea Elemento Import (MSBuild) y Cómo: Utilizar el mismo destino en varios archivos de proyecto.

/property:name=value

/p:name=value

El conjunto o invalida las propiedades especificadas en el nivel de proyecto, donde es el nombre de propiedad name y value es el valor de propiedad.Especifique cada propiedad por separado, o utilice un punto y coma o una coma para separar varias propiedades, como se muestra en el ejemplo siguiente:

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

/target:targets

/t:targets

Compile los destinos especificados en el proyecto.Especifique cada destino por separado, o utilice un punto y coma o una coma para separar varios destinos, como se muestra en el ejemplo siguiente:

/target:Resources;Compile

Si especifica los destinos utilizando este modificador, se ejecutan en lugar de los destinos en el atributo de DefaultTargets en el archivo de proyecto.Para obtener más información, vea Orden de compilación de destinos y Cómo: Especificar qué destino utilizar primero al compilar.

Un destino es un grupo de tareas.Para obtener más información, vea Objetivos de MSBuild.

/toolsversion:version

/tv:version

Especifica la versión del conjunto de herramientas para utilizar para compilar el proyecto, como se muestra en el ejemplo siguiente: /toolsversion:3.5

Mediante este modificador, puede compilar un proyecto y especificar una versión diferente de la versión que se especifica en Elemento Project (MSBuild).Para obtener más información, vea Invalidar el valor de la versión de herramientas.

Para MSBuild 4,5, puede especificar los siguientes valores para version: 2,0, 3,5, y 4,0.Si especifica 4,0, la propiedad de compilación de VisualStudioVersion especifica que sub- conjunto de herramientas a utilizar.Para obtener más información, vea la sección de los Sub- conjuntos de herramientas de Conjunto de herramientas de MSBuild (ToolsVersion).

Un Conjunto consta de las tareas, los destinos, y herramientas que se utilizan para compilar una aplicación.Las herramientas incluye compiladores como csc.exe y vbc.exe.Para obtener más información sobre los conjuntos de herramientas, vea Conjunto de herramientas de MSBuild (ToolsVersion), Configuraciones de conjuntos de herramientas estándar y personalizados, y Información general sobre compatibilidad con múltiples versiones (multi-targeting) de MSBuild.

NotaNota
La versión del conjunto de herramientas no es igual que el marco de destino, que es la versión de .NET Framework en la que se compila un proyecto de ejecutarse.Para obtener más información, vea Versión de .NET Framework de destino y plataforma de destino de MSBuild.

/validate: [schema]

/val [schema]

Valide el archivo de proyecto y, si la validación es correcta, compile el proyecto.

Si no especifica schema, el proyecto se valida con el esquema predeterminado.

Si especifica schema, el proyecto se valida con el esquema especificado.

El valor siguiente es un ejemplo: /validate:MyExtendedBuildSchema.xsd

/verbosity:level

/v:level

Especifica la cantidad de información en la pantalla en el registro de compilación.Cada registrador muestra eventos basándose en el nivel de detalle que se establece para dicho registrador.

Puede especificar los niveles de detalle siguientes: q[uiet], m[inimal], n[ormal], d[etailed], y diag[nostic].

El valor siguiente es un ejemplo: /verbosity:quiet

/version

/ver

Información de versión de la pantalla.El proyecto no se compila.

@file

Modificadores de la línea de comandos INSERT de un archivo de texto.Si tiene varios archivos, se especifica por separado.Para obtener más información, vea Archivos de respuesta de MSBuild.

ms164311.collapse_all(es-es,VS.110).gifModificadores para los registradores

Modificador

Forma abreviada

Descripción

/consoleloggerparameters:parameters

/clp:parameters

Pase los parámetros que se especifica el registrador de la consola, que muestra información de compilación en la ventana de la consola.Puede especificar los siguientes parámetros:

  • PerformanceSummary.Muestra el tiempo empleado en tareas, destinos, y proyectos.

  • Resumen.Muestra el resumen de errores y advertencias en el extremo.

  • NoSummary.No muestra el resumen de errores y advertencias en el extremo.

  • ErrorsOnly.Sólo muestra los errores.

  • WarningsOnly.Sólo muestra las advertencias.

  • NoItemAndPropertyList.No mostrar la lista de elementos y propiedades que se producen al principio de cada proyecto compilará si el nivel de detalle se establece en diagnostic.

  • ShowCommandLine.Muestra los mensajes de TaskCommandLineEvent.

  • ShowTimestamp.Muestra la marca de tiempo como prefijo a cualquier mensaje.

  • ShowEventId.Muestra el Id. de evento para cada evento iniciado, el evento finalizado, y el mensaje.

  • ForceNoAlign.No alinear el texto al tamaño del búfer de consola.

  • DisableConsoleColor.Utilice los colores predeterminados de la consola para todos los mensajes de registro.

  • DisableMPLogging.Deshabilite el estilo de registro para varios procesadores de salida para ejecutarse en modo de no multiprocesador.

  • EnableMPLogging.Habilite el estilo de registro para varios procesadores incluso cuando se ejecuta en modo de no multiprocesador.Este estilo de registro está activada de forma predeterminada.

  • Detalle.Reemplace /verbosity que establece para este registrador.

Utilice un punto y coma o una coma para separar varios parámetros, como se muestra en el ejemplo siguiente:

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

/distributedFileLogger

/dfl

Registrar el resultado de la compilación de cada nodo de MSBuild a su propio archivo.La ubicación inicial de estos archivos es el directorio actual.De forma predeterminada, los archivos se denominan “MSBuild NodeId.log”.Puede utilizar el modificador /fileLoggerParameters para especificar la ubicación de los archivos y otros parámetros del fileLogger.

Si llama a un archivo de registro mediante el modificador /fileLoggerParameters, el registrador distribuido usará ese nombre como plantilla y anexará el identificador de nodo a ese nombre al crear un archivo de registro para cada nodo.

/distributedlogger:central logger*forwarding logger

/dl:central logger*forwarding logger

Eventos de registro de MSBuild, adjuntando una instancia diferente del registrador a cada nodo.Para especificar varios registradores, hágalo por separado.

Utiliza la sintaxis de registrador para especificar un registrador.Para la sintaxis de registrador, vea el modificador de /logger abajo.

Los ejemplos siguientes se muestra cómo utilizar este modificador:

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

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

/fileLogger [número]

/fl [number]

Registrar los resultados en un solo archivo en el directorio actual.Si no especifica number, el archivo de salida se denomina msbuild.log.Si especifica number, el archivo de salida se denomina msbuild n.log, donde es number n.Number puede ser un dígito comprendido entre 1 y 9.

Puede utilizar el modificador /fileLoggerParameters para especificar la ubicación del archivo y otros parámetros del fileLogger.

/fileloggerparameters: [número] parameters

/flp: [ number] parameters

Especifique un parámetro adicional para el registrador de archivo y el registrador distribuido del archivo.La presencia de este modificador implica que el correspondiente o el modificador filelogger[number] está presente.Number puede ser un dígito comprendido entre 1 y 9.

Puede utilizar todos los parámetros que se enumeran para /consoleloggerparameters.También puede utilizar uno o más de los parámetros siguientes:

  • Archivo de diario.La ruta de acceso al archivo de registro en el que se escribe el registro de compilación.Los prefijos enrutados de registrador de archivo esta ruta a los nombres de los archivos de registro.

  • Anexe.Determina si el registro de compilación se adjuntará al archivo de registro o sobrescribe.Cuando se establece el modificador, el registro de compilación se anexa al archivo de registro.Si no establece el modificador, el contenido de un archivo de registro existente se sobrescriben.

  • La codificación.Especifica la codificación del archivo (por ejemplo, UTF-8, Unicode, o ASCII).

El ejemplo siguiente genera archivos de registro independientes para las advertencias y los errores:

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

Los ejemplos siguientes muestran otras posibilidades:

/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

Especifica el registrador que se debe utilizar para registrar los eventos de MSBuild.Para especificar varios registradores, hágalo por separado.

Uso The después de la sintaxis para logger: [LoggerClass,]LoggerAssembly[;LoggerParameters]

Utilice la sintaxis siguiente para LoggerClass: [PartialOrFullNamespace.]LoggerClassName

No tiene que especificar la clase de registrador si el ensamblado contiene exactamente un registrador.

Utilice la sintaxis siguiente para LoggerAssembly: {AssemblyName[,StrongName] |AssemblyFile}

Los parámetros del registrador son opcionales y se pasan al registrador exactamente como se escriben.

Los ejemplos siguientes se utiliza el modificador /logger.

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

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

/noconsolelogger

/noconlog

Deshabilitar el registrador de la consola predeterminado, y no registrar eventos en la consola.

Ejemplo

En el siguiente ejemplo se compila el destino rebuild del proyecto MyProject.proj.

MSBuild.exe MyProject.proj /t:rebuild

Puede utilizar MSBuild.exe para realizar compilaciones más complejas.Por ejemplo, puede utilizarlo para compilar determinados destinos de proyectos específicos en una solución.El ejemplo siguiente recompilar el proyecto NotInSolutionFolder y limpia el proyecto InSolutionFolder, que se encuentra en la carpeta de la solución de NewFolder.

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

Vea también

Referencia

Propiedades comunes de proyectos de MSBuild

Otros recursos

Referencia de MSBuild