Destroy (Comando, Team Foundation Build)
Puede utilizar el comando TFSBuild destroy para destruir compilaciones completadas de forma permanente. Destruir compilaciones completadas ya obsoletas, puede ayudarle a ahorrar espacio en su almacenamiento de datos.
.gif "Nota de precaución") Precaución |
|---|
Utilice este comando con precaución porque no puede revertir su efecto. |
Este comando elimina permanentemente el registro de base de datos de una compilación, pero no los artefactos relacionados con la misma, como colocaciones, etiquetas del control de versiones y resultados de pruebas. Puede utilizar el comando TFSBuild delete para eliminar los artefactos antes de destruir permanentemente la compilación.
Permisos necesarios
Para utilizar el comando destroy, el permiso Destruir compilaciones debe estar establecido en Permitir. Este permiso se da automáticamente a los administradores de la colección de proyecto de equipo, administradores del proyecto y generadores. Para obtener más información, vea Permisos de Team Foundation Server.
TFSBuild destroy /collection:TeamProjectCollectionUrl /BuildDefinition:DefinitionSpec BuildNumber [BuildNumber...] [/noprompt] [/silent] [/preview]
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
TFSBuild destroy TeamProjectCollectionUrl TeamProject BuildNumber [BuildNumber...]
TFSBuild destroy /collection:TeamProjectCollectionUrl /DateRange: [Date]~[Date] /BuildDefinition:DefinitionSpec
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
Parámetros
Argumento |
Descripción |
|---|---|
TeamProjectCollectionUrl |
La dirección URL de la colección de proyectos de equipo que contiene la compilación que desea destruir (por ejemplo, http://myserver:8080/tfs/DefaultCollection). |
DefinitionSpec |
Se utiliza con /BuildDefinition. Las definiciones de compilación que desea destruir. Puede utilizar caracteres comodín. |
BuildNumber |
Una lista separada por espacios de las compilaciones que se van a destruir. Si el número de compilación tiene espacios, incluya el número entre comillas simples. Puede utilizar caracteres comodín. |
BuildUri |
Una lista separada por espacios de los identificadores URI de las compilaciones que se van a destruir. |
TeamProject |
Nombre del proyecto de equipo para el que existe esta definición de compilación. |
Date |
Se utiliza para la opción /daterange. Una fecha en cualquier formato que .NET Framework pueda analizar. Puede especificar los intervalos de fechas utilizando "~" como muestran los siguientes ejemplos:
|
Opción |
Descripción |
|---|---|
/collection |
Especifica la colección del proyecto de equipo. |
/BuildDefinition |
Especifica la definición o definiciones de compilación que desea eliminar. |
/preview |
Muestra las compilaciones que se van a destruir en la ventana de símbolo del sistema. Al especificar esta opción, realmente no se destruyen las compilaciones. |
/noprompt |
Especifica que no se pida confirmación cuando se está eliminando una compilación. |
/silent |
Especifica que no se escriba el resultado en la ventana del símbolo del sistema mientras se eliminan las compilaciones. Implica /noprompt. |
Comentarios
Si intenta destruir una compilación sin el permiso adecuado, un cuadro de diálogo le informa de ese hecho.
Ejemplo
El siguiente ejemplo destruye permanentemente compilaciones que son anteriores al 20 de noviembre de 2010 y que se basan en la definición de compilación "Compilación nocturna" del proyecto de equipo "Nuevos trabajos".
>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20
Vea también
Tareas
Eliminar una compilación completada
Crear una definición de compilación básica
Otros recursos
Comandos de Team Foundation Build