Comando start (Team Foundation Build)

Artículo
10/07/2008

Actualización: noviembre 2007

Utilice el comando de start para ejecutar una definición de compilación de Team Foundation Build configurada.

Permisos necesarios

Para utilizar el comando start, debe tener el permiso de seguridad de Team Foundation ServerIniciar una compilación establecido en Permitir. Además, la cuenta de servicio del nivel 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.

Nota:
Incluso si ha iniciado sesión con credenciales administrativas, debe abrir un símbolo del sistema con permisos elevados para realizar esta función en un servidor que ejecute Windows Server 2008. Para abrir un símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, visite el sitio web de Microsoft.

Incluso si ha iniciado sesión con credenciales administrativas, debe abrir un símbolo del sistema con permisos elevados para realizar esta función en un servidor que ejecute Windows Server 2008. Para abrir un símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, visite el sitio web de Microsoft.

TFSBuild start /server:teamFoundationServer 
/builddefinition:definitionSpec [/droplocations:dl] [/getoption:go] 
[/customgetversion:versionSpec] [/priority:p] [/requestedfor:userName] 
[/msbuildarguments:args] [/silent] [/queue]

TFSBuild start teamFoundationServer teamProject definitionName 
[/droplocation:dl] [/getoption:go] [priority:p]
  [/customversion:versionSpec] [/requestedfor:userName]
[/msbuildarguments:args] [/silent] [/queue]

Parámetros

Argumento	Descripción
teamFoundationServer	Dirección URL del servidor de Team Foundation donde se protegen las soluciones que se generan.
teamProject	Nombre del proyecto de equipo que tiene las soluciones que se van a generar.
definitionName	Nombre de la definición de compilación en el proyecto de equipo que se va a utilizar para la compilación.
dl	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 /droplocations.
go	Se utiliza con la opción /getoption. Los valores válidos son LatestOnQueue, LatestOnBuild y Custom.
versionSpec	Versión de los archivos que se generan cuando la opción /getoption está establecida en Custom. Se utiliza con la opción /customgetversion. Puede especificar una versión por: Fecha y hora (D10/20/2005) Versión del conjunto de cambios (C1256) Etiqueta (Lmylabel) Última versión (T) Versión del área de trabajo (Wworkspacename;owner)
p	Prioridad de la cola utilizada para la definición de compilación. Se utiliza con la opción /priority. Los valores válidos son: Low, BelowNormal, Normal, AboveNormal y High.
userName	Usuario que solicita la compilación.
args	Argumentos de la línea de comandos que se pasan a MSBuild.

Opción	Descripción
/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. 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 se obtienen del control de versiones.
/customgetversion	Opcional. Especifica la versión personalizada de los archivos que se obtienen si el valor de /getoption se especifica 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"
/silent	Opcional. Al especificar esta opción, el resultado no se escribe en la ventana de símbolo del sistema mientras 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 FoundationTFSBuild 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 almacenar las compilaciones, como para la cuenta del personal de pruebas para la publicación de los resultados de las pruebas.

Ejemplo

>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"

En el ejemplo siguiente se genera el tipo de compilación nocturna que se encuentra en el proyecto de equipo AdventureWorks en server01. La compilación resultante se almacena 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, consulte Referencia de la línea de comandos de MSBuild.

>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"