Compartir a través de


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 , 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 valor versionspec. El valor de versionspec 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 de versionspec, 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