Destruir archivos controlados por versiones
Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Con el tiempo, un servidor de control de versiones adquiere un número creciente de archivos y carpetas. Esto puede causar problemas al intentar administrar los requisitos de espacio en disco. Es posible que se le obligue a quitar todos los proyectos y sus jerarquías del control de versiones. Por ejemplo, un proyecto podría crearse solo con fines de aprendizaje, o quizás algunos archivos estén contaminados con un virus. Por lo tanto, como administrador de TFVC, en ocasiones es posible que tenga que destruir archivos y carpetas que están bajo control de versiones.
En el procedimiento siguiente se muestra cómo destruir archivos y carpetas mediante el comando tf destroy
. Aunque los archivos se quitan permanentemente, puede conservar el historial asociado a ellos. A fin de obtener más información sobre las opciones y argumentos disponibles para tf destroy
, vea Comando Destroy (Control de versiones de Team Foundation).
Nota
La operación destroy
solo está disponible desde la línea de comandos.
Prerrequisitos
Para poder usar el comando
, debe ser miembro del grupo de seguridad de Administradores de Team Foundation . Para más información, vea Permisos predeterminados de TFVC. Antes de ejecutar
tf destroy
sin la opción/keephistory
, elimine primero los archivos que desea destruir. Para obtener más información, vea Eliminar archivos y carpetas del control de versiones. Después de eliminar un archivo, su nombre de archivo ahora incluye un identificador de eliminación. Por ejemplo, si un nombre de archivo es aFile.cs, después de eliminar el nombre de archivo es aFile.cs; x123, donde x123 es el identificador de eliminación.Después de eliminar los archivos, puede sincronizar el almacenamiento de TFVC. De lo contrario, el almacén no se sincronizará con los elementos destruidos.
Para destruir permanentemente archivos controlados por versiones
En Windows, seleccione Inicio y, después, escriba Símbolo del sistema para desarrolladores. En los resultados de la búsqueda, seleccione el símbolo del sistema para desarrolladores para la versión de Visual Studio, como símbolo del sistema para desarrolladores para Visual Studio 2022.
Para obtener una vista previa de la destrucción del archivo aFile.cs sin destruirlo, escriba lo siguiente en el símbolo del sistema:
tf destroy /preview /i $/MyTeamProject/aFile.cs
Nota
El texto de la ventana del símbolo del sistema muestra
Destroyed: $/MyTeamProject/aFile.cs
, pero el archivo no se destruye realmente cuando se usa la opción/preview
.Para destruir el archivo aFile.cs, escriba en la línea de comandos:
tf destroy /i $/MyTeamProject/aFile.cs
En este comando se muestra información sobre los posibles cambios pendientes y los conjuntos de cambios agregados pendientes de confirmación en la ventana del símbolo del sistema. Si especifica
/i
o no interactivo, no aparecerá el cuadro de diálogo Sí, No o Sí a todo antes de quitar permanentemente los archivos.Para destruir todos los archivos de aFolder y al mismo tiempo conservar su historial, escriba:
tf destroy /keephistory $/MyTeamProject/aFolder
Nota
No puede especificar
/preview
con/keephistory
.Esta acción conserva la información histórica sobre todos los archivos de aFolder. Puede usar el comando
tf history
para ver el historial de un archivo. También puede ver el historial en el Explorador de control de código fuente en Visual Studio. Para obtener más información, vea Comando History y Obtención del historial de un elemento.Use la opción
/stopat
para conservar la información histórica hasta un momento determinado, incluido un valorversionspec
. El valor deversionspec
puede ser la versión más reciente, un conjunto de cambios específico o una fecha. Para obtener más información sobre los valores deversionspec
, consulte Uso de comandos de control de versiones de Team Foundation.Para destruir todos los archivos del proyecto MyTeamProject y, al mismo tiempo, conservar el historial de los archivos hasta el 23/10/23/2005, escriba:
tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005
Use la opción
/startcleanup
para limpiar inmediatamente los metadatos de TFVC de los archivos a los que ya no hace referencia Azure DevOps Server. Sin esta opción, esos metadatos se quitan cuando una base de datos se mantiene mediante un proceso SQL que se ejecuta cada cinco días. Siete días después de la eliminación de metadatos de TFVC, otro proceso SQL eliminará el contenido de los archivos destruidos.Para destruir inmediatamente todos los archivos de aFolder, escriba:
tf destroy /startcleanup $/MyTeamProject/aFolder