Start (Comando, Team Foundation Build)
Utilice el comando de start para ejecutar una definición de compilación configurada de Team Foundation Build.
Permisos necesarios
Para usar el comando start, debe tener los permisos de seguridad Poner compilaciones en cola y Ver definición de compilación de Visual Studio Team Foundation Server establecidos en Permitir. Además, la cuenta de servicio de la capa de aplicación y la cuenta de servicio de Team Foundation Build deben tener permisos de lectura y escritura en la ubicación de destino de la compilación. Para obtener más información, vea Permisos de Team Foundation Server.
TFSBuild start /collection:teamProjectCollectionUrl
/builddefinition:definitionSpec [/droplocation:droplocation] [/getoption:getoption]
[/customgetversion:versionSpec] [/priority:priority] [/requestedfor:userName]
[/msbuildarguments:args] [/shelveset:shelvesetName [/checkin]]
[/silent] [/queue]
TFSBuild start teamProjectCollectionUrl teamProject definitionName
[/droplocation:droplocation] [/getoption:getoption] [priority:priority]
[/customgetversion:versionSpec] [/requestedfor:userName]
[/shelveset:shelvesetName [/checkin]]
[/msbuildarguments:args] [/silent] [/queue]
Parámetros
Argumento |
Descripción |
|---|---|
teamProjectCollectionUrl |
Dirección URL de la colección de proyectos de equipo que contiene las soluciones y proyectos que se compilan. |
teamProject |
Nombre del proyecto de equipo que contiene las soluciones y los proyectos que se están compilando. |
definitionName |
Nombre de la definición de compilación en el proyecto de equipo que se va a utilizar para la compilación. |
droplocation |
Ruta de acceso a la carpeta pública en la que se almacenan los archivos binarios y de registro de la compilación una vez finalizada la compilación. Por ejemplo, \\servidor\recurso compartido. Se utiliza con la opción /droplocation. |
getoption |
Se utiliza con la opción /getoption. Los valores válidos son LatestOnQueue, LatestOnBuild y Custom. |
versionSpec |
|
priority |
Prioridad de la cola utilizada para la definición de compilación. Use este argumento con la opción /priority. Los valores válidos son Low, BelowNormal, Normal, AboveNormal y High. |
userName |
Nombre del usuario que se va a asociar a la compilación completada. |
args |
Argumentos de la línea de comandos que se pasan a MSBuild. |
shelvesetName |
Especifique el nombre de un conjunto de cambios aplazados si desea iniciar una compilación privada o está iniciando una compilación que se define con el desencadenador de protección controlada. |
Opción |
Descripción |
|---|---|
/collection |
Especifica la colección del proyecto de equipo. |
/droplocation |
Opcional. Especifica el directorio donde se produce el proceso de compilación. Se puede abreviar como /d. De forma predeterminada se utiliza el directorio de compilación especificado en la definición de compilación. .gif "Nota") Nota
Al seleccionar el directorio de compilación, asegúrese de que hay espacio suficiente para realizar la compilación ya que, de lo contrario, se podría cancelar la compilación.
|
/getoption |
Opcional. Especifica los archivos que desea obtener del control de versiones. |
/customgetversion |
Opcional. Especifica la versión personalizada de los archivos que desea obtener si especifica el valor de /getoption como Custom. |
/priority |
Opcional. Especifica la prioridad de cola de la compilación. |
/requestedfor |
Opcional. Especifica para quién se solicitó la compilación. |
/msbuildarguments |
Opcional. Especifica los argumentos de la línea de comandos que se pasan a MSBuild. El formato general es: /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
/shelveset |
Opcional. Especifique el nombre de un conjunto de cambios aplazados si desea iniciar una compilación privada o está iniciando una compilación que se define con el desencadenador de protección controlada. |
/checkin |
Opcional. Esta opción sólo se aplica si está iniciando una compilación que se define con el desencadenador de protección controlada. Especifique esta opción si desea que el sistema proteja los archivos si la compilación es correcta. |
/silent |
Opcional. Al especificar esta opción, el resultado no se escribe en la ventana de símbolo del sistema cuando se ejecuta la compilación. |
/queue |
Inserta las solicitudes de inicio de compilación en la cola de compilaciones y termina inmediatamente. |
Comentarios
Puede utilizar el comando de la línea de comandos de Team Foundation TFSBuild start con el servicio del Programador de tareas para realizar compilaciones periódicas o nocturnas.
Si se genera más de una solución, considere una solución que tenga dependencias en otra al determinar el orden de compilación. Por ejemplo, puede establecer que Solution1 se genere antes de Solution2 si Solution2 tiene una dependencia en Solution1
De forma predeterminada, el directorio de destino no se crea automáticamente como un recurso compartido. Por tanto, no está disponible para publicar los resultados de las compilaciones y las pruebas. Debe establecer manualmente un recurso compartido y agregar permisos de escritura al directorio de Windows y permisos de recursos compartidos tanto para la cuenta utilizada para ejecutar Team Build Service para colocar las compilaciones, como para la cuenta del personal de pruebas para la publicación de los resultados de las pruebas.
Ejemplo
En el siguiente ejemplo se compila el tipo de compilación nocturna que se encuentra en la colección de proyectos de equipo AdventureWorks en la colección en http://myserver:8080/DefaultCollection. La compilación resultante se almacena en el directorio BuildDrop.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
En el siguiente ejemplo se compila el tipo de compilación nocturna que se encuentra en el proyecto de equipo AdventureWorks en la colección en http://myserver:8080/DefaultCollection. La compilación resultante está en el directorio BuildDrop. Utilice la opción /msbuildarguments para pasar el nivel de contenido de diagnóstico de MSBuild. Para obtener más información, vea Referencia de la línea de comandos de MSBuild.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Vea también
Tareas
Crear una definición de compilación básica
Otros recursos
Comandos de Team Foundation Build