Cómo: Destruir archivos bajo control de versiones

Actualización: noviembre 2007

Con el tiempo, un servidor del control de versiones adquiere un número cada vez mayor de archivos y carpetas. Esto puede producir problemas al intentar administrar las necesidades de espacio en disco. Puede verse obligado a quitar todos los proyectos de equipo y sus jerarquías del control de versiones. Por ejemplo, es posible que se haya creado un proyecto de equipo con fines de aprendizaje o que algunos archivos estén contaminados con un virus. Por tanto, como administrador Team Foundation, puede que en algún momento tenga que destruir archivos y carpetas que están bajo el control de versiones.

En el procedimiento siguiente se muestra cómo destruir archivos y carpetas mediante el comando tf destroy. Aunque los archivos se eliminan permanentemente, puede conservar el historial asociado a ellos. Para obtener más información sobre las opciones y argumentos disponibles para tf destroy, vea Comando destroy.

Nota:
Esta operación sólo está disponible desde la línea de comandos.

Permisos necesarios

Para utilizar el comando destroy, debe ser un miembro del grupo de seguridad Administradores de Team Foundation. Para obtener más información, consulte Permisos de Team Foundation Server.

Requisitos previos para ejecutar tf destroy

Antes de ejecutar tf destroy sin la opción /keephistory, es recomendable que primero elimine los archivos que desea destruir. Para obtener más información, consulte Cómo: Eliminar archivos y carpetas del control de versiones. Después de eliminar un archivo, el nombre de archivo incluye un identificador de eliminación. Por ejemplo, si el nombre de archivo es aFile.cs, después de la eliminación el nombre de archivo será aFile.cs;x 123, donde x123 es el identificador de eliminación.

Después de eliminar los archivos, puede sincronizar el almacén de datos de Team Foundation. De lo contrario, el almacén de datos no se sincronizará con los elementos destruidos. Para obtener más información, consulte Planear la sincronización con el almacén de datos.

Para destruir permanentemente archivos con control de versiones

• Haga clic en Inicio, Todos los programas, Microsoft Visual Studio 2008, Visual Studio Tools y Símbolo del sistema de Visual Studio.

  • Para obtener una vista previa 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 de símbolo del sistema indica "Destruido: $/MiProyectoDeEquipo/aFile.cs", pero en realidad el archivo no se destruye al utilizar la opción /preview.

  • Para destruir el archivo aFile.cs, escriba lo siguiente en el símbolo del sistema:

    >tf destroy /i $/MyTeamProject/aFile.cs
    

    Este comando muestra información sobre los posibles cambios pendientes y conjuntos de cambios aplazados en la ventana de símbolo del sistema. Como ha especificado /i (no interactivo), no se pide confirmación con un cuadro de diálogo Yes, No, Yes to all antes de que se eliminen permanentemente los archivos.

  • Para destruir todos los archivos en aFolder y, al mismo tiempo, conservar su historial, escriba:

    >tf destroy /keephistory $/MyTeamProject/aFolder
    

    Nota:
    /preview no se puede especificar con /keephistory.

    Esta acción conserva la información histórica de todos los archivos en aFolder. Puede utilizar 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. Para obtener más información, consulte Comando history y Cómo: Ver datos del historial.

  • Utilice la opción /stopat para conservar la información histórica hasta el valor especificado para versionSpec, inclusive. El valor de versionSpec puede ser la última versión, un conjunto de cambios concreto o una fecha. Para obtener más información acerca de los valores de versionspec, vea Sintaxis de la línea de comandos (Team System).

    Para destruir todos los archivos del proyecto de equipo MyTeamProject y, al mismo tiempo, conservar el historial de los archivos hasta 10/23/2005, inclusive, escriba:

    >tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005
    

  • Utilice la opción /startcleanup para limpiar inmediatamente el contenido al que Team Foundation Server ya no hace referencia. Sin esta opción, los archivos destruidos se quitan cuando un proceso de SQL, que generalmente se ejecuta una vez al día, realiza un mantenimiento de la base de datos.

    Para destruir inmediatamente todos los archivos de aFolder, escriba:

    >tf destroy /startcleanup $/MyTeamProject/aFolder
    

Vea también

Tareas

Cómo: Mover, cambiar de nombre y eliminar archivos y carpetas bajo control de versiones

Conceptos

Operaciones disponibles sólo desde la línea de comandos (Control de versiones de Team Foundation)

Referencia

Comando destroy

Otros recursos

Referencia de la línea de comandos del control de versiones de Team Foundation