Delete (Comando, Team Foundation Build)
Puede utilizar el comando delete para eliminar una compilación completada, incluyendo algunos o todos los datos relacionados.
Nota
Este comando no elimina datos del almacén; para realizar este tipo de operación, use el comando destroy. Para obtener más información, vea Destroy (Comando, Team Foundation Build).
Permisos necesarios
Para ejecutar el comando delete, la cuenta que solicita la operación de eliminación debe tener el permiso Eliminar compilaciones establecido en Permitir. Si la compilación que se elimina tiene resultados de pruebas asociados a ella, la cuenta debe tener el permiso Publicar resultados de la prueba 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.
TFSBuild delete /collection:teamProjectCollectionUrl /builddefinition:definitionSpec buildnumber[buildNumber...] [/deleteOptions:deleteOptions] [/noprompt] [/silent] [/preview]
TFSBuild delete /collection:teamProjectCollectionUrl buildUri[buildUri...]
TFSBuild delete teamProjectCollectionUrl teamProject buildNumber[buildNumber...]
TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] /buildDefinition:definitionSpec
TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] teamProject
Parámetros
Argumento |
Descripción |
---|---|
teamProject |
Nombre del proyecto de equipo para el que existe esta definición de compilación. |
definitionSpec |
Se utiliza con /builddefinition. La compilación o compilaciones que desea eliminar. Se admiten caracteres comodín. |
buildNumber |
Una lista separada por espacios de las compilaciones que se van a eliminar. Si el número de compilación tiene espacios, incluya el número entre comillas simples. Se admiten caracteres comodín. |
buildUri |
Una lista separada por espacios de los identificadores URI de las compilaciones que se van a eliminar. |
teamProjectCollectionUrl |
La dirección URL de la colección de proyectos de equipo que contiene la compilación que desea eliminar (por ejemplo, http://myserver:8080/tfs/DefaultCollection). |
deleteOptions |
El valor que el usuario proporciona para la opción /deleteOptions. Para eliminar una compilación, puede especificar una o varias de las siguientes opciones:
|
date |
Valor proporcionado por el usuario para la opción /daterange. Puede especificar los intervalos de fechas utilizando "~" como muestran los siguientes ejemplos:
|
Opción |
Descripción |
---|---|
/noprompt |
No preguntar cuando se está eliminando una compilación. |
/silent |
No escribir los resultados en la ventana de símbolo del sistema durante la eliminación. Implica /noprompt. |
/builddefinition |
Especifica la definición o definiciones de compilación que desea eliminar. |
/collection |
Especifica la colección del proyecto de equipo. |
/deleteOptions |
Especifica las opciones para eliminar una compilación. |
/preview |
Muestra lo que ocurriría sin realizar realmente la operación delete. |
/daterange |
Especifica el intervalo de fechas de las compilaciones que desea eliminar. |
Comentarios
Eliminar proceso
Si se produce un error durante este proceso, aparecerá un mensaje de advertencia. Sin embargo, incluso si aparece una advertencia, se considera que la eliminación se ha realizado correctamente.
Se eliminan varias generaciones
Si especifica varias compilaciones, el proceso no se detiene al producirse un error cuando se elimina una de las compilaciones. El comando sigue eliminando las otras compilaciones después de proporcionar un mensaje de error sobre la eliminación de la compilación.
Registro de eventos
Las eliminaciones de generaciones se registran en el registro de eventos. El registro contendrá información sobre quién eliminó la compilación, la hora en que se eliminó y el número de compilación.
Ejemplo
En el siguiente ejemplo se eliminan dos compilaciones definidas por los números de compilación "TestBuild1 1_20070510.1" y "TestBuild 1_20070510.2" del proyecto de equipo AdventureWorks en la colección de proyectos de equipo en http://myserver:8080/tfs/DefaultCollection.
> > tfsbuild.exe delete http://myserver:8080/tfs/DefaultCollection Adventureworks "TestBuild1 1_20070510.1" "TestBuild 1_20070510.2"
El siguiente ejemplo elimina dos compilaciones concretas donde definitionSpec es "\Adventureworks\Definition1" del proyecto de equipo AdventureWorks en la colección de proyectos de equipo en http://myserver:8080/tfs/DefaultCollection.
>tfsbuild.exe delete /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"\Adventureworks\Definition 1" "Definition 1_20070510.1" "Definition 1_20070510.2"
En el siguiente ejemplo se eliminan dos compilaciones definidas por los URI de compilación "vstfs:///TestBuild/TestBuild/1" y "vstfs:///TestBuild/TestBuild/2" del proyecto de equipo AdventureWorks en la colección de proyectos de equipo en http://myserver:8080/tfs/DefaultCollection.
>tfsbuild.exe delete /collection:http://myserver:8080/tfs/DefaultCollection vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29
Vea también
Tareas
Eliminar una compilación completada