Comando destroy
Actualización: noviembre 2007
Utilice el comando tf destroy para destruir o eliminar permanentemente archivos con control de versiones de Control de versiones de Team Foundation.
La acción de destrucción no se puede deshacer. No debe destruir archivos que aún se necesiten. A veces tendrá que limpiar los sistemas del control de versiones. Por ejemplo, si algunos archivos se infectan con un virus informático, tendrá que quitarlos permanentemente del control de versiones.
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, vea Cómo: Eliminar archivos y carpetas del control de versiones.
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, vea Planear la sincronización con el almacén de datos.
Permisos necesarios
Para utilizar el comando destroy, debe pertenecer al grupo de seguridad Administradores de Team Foundation. Para obtener más información, vea Permisos de Team Foundation Server.
tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>…<itemspecN>]
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt]
Parámetros
Argumento |
Description |
|---|---|
itemspec1[itemspec2…itemspecN] |
Especifica la ruta de acceso en el servidor del archivo o la carpeta que se va a destruir. Utilice varios valores itemspec para eliminar varios elementos. Por ejemplo: tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3. No se admiten rutas de acceso locales. |
versionspec |
Proporciona una versión como C58 para las opciones /keephistory o /stopat. Los valores permitidos son una fecha, una sugerencia o un conjunto de cambios específico. Para obtener más información acerca de cómo Team Foundation analiza una especificación de versión para determinar qué elementos se encuentran en su ámbito, vea Sintaxis de la línea de comandos (Team System). |
Option |
Description |
|---|---|
/keephistory |
Opcional. Especifica que se conserve el historial de un archivo aunque se destruya su contenido. Esto no se puede especificar con la opción /preview. |
/stopat |
Opcional. Sólo se puede utilizar si también se especifica /keephistory. Especifica la versión del archivo y de los siguientes archivos cuyo historial se va a conservar. La versión predeterminada de /stopat es la sugerencia (T) de la última versión protegida de un elemento. No puede utilizar valores de versionspec de etiqueta o área de trabajo para especificar un elemento para la opción /stopat. |
/preview |
Muestra los archivos que se van a destruir en la ventana de símbolo del sistema. Cuando tf destroy se ejecuta en el modo de vista previa, los archivos en realidad no se destruyen. .gif "Nota") Nota:
El texto de la ventana de símbolo del sistema muestra la palabra "Destruido" para cada archivo que se va a destruir. Pero el archivo no se destruye cuando se utiliza la opción /preview.
|
/startcleanup |
Obliga al proceso de limpieza del contenido del archivo a que se inicie inmediatamente después de que finalice la eliminación del contenido. Si el usuario no especifica /startcleanup, el proceso de limpieza de contenido destruido tiene lugar cuando el mantenimiento de la base de datos limpia todos los archivos a los que Team Foundation Server ya no hace referencia. De forma predeterminada, la limpieza está programada para que se ejecute una vez al día. |
/noprompt /i |
Especifica que la destrucción de archivos no es interactiva. /i es un alias de /noprompt. |
Comentarios
Cuando se utiliza tf destroy para destruir archivos con control de versiones, el nivel de aplicación de Team Foundation Server recibe la solicitud de destrucción y comprueba si el usuario es miembro del grupo de seguridad Administradores de Team Foundation. Si no es miembro, el sistema muestra un cuadro de diálogo de mensaje de error en el que se indica que el usuario no dispone de suficientes permisos para realizar la operación.
Después de que el sistema comprueba loa permisos, ejecuta el comando destroy. Este comando elimina todas las referencias de archivo, conjuntos de cambios aplazados y cambios pendientes. La destrucción real de los archivos, que es una eliminación permanente, se produce la próxima vez que se limpia el contenido al que Team Foundation Server ya no hace referencia. También puede especificar la opción /startcleanup para limpiar los archivos inmediatamente después de que se ejecute tf destroy.
Si ejecuta tf destroy sin especificar /i ni /preview, el sistema muestra un mensaje Yes o No en la consola para cada valor de filespec. En caso contrario, puede especificar Yes to all. Si no especifica /keephistory, se mostrará un texto interactivo para avisarle de los cambios pendientes, si existen. El texto interactivo señala a /preview si desea más información sobre los cambios. Si especifica /keephistory, aparece también el texto Yes, No o All para pedir confirmación. Si selecciona Yes o All, se inicia el proceso de destrucción y las rutas de acceso del servidor a los elementos destruidos aparecen en la ventana del símbolo del sistema.
Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: …
Si ha especificado el valor de versionspec como una sugerencia, las rutas de acceso del servidor mostradas en la ventana del símbolo del sistema incluyen los identificadores de eliminación. Por ejemplo, podría aparecer X123 en la ventana del símbolo del sistema.
Si utiliza la opción /preview, no se destruyen los archivos, sino que se muestran los archivos que se van a destruir en el texto de la línea de comandos. Por ejemplo, si en la línea de comandos escribe tf destroy /preview $/Test1/MyProject/MyProject/Program.cs, en la ventana de comandos se muestra este texto:
Destroyed: $/Test1/MyProject/MyProject/Program.cs
Pero el archivo no se destruye porque ha utilizado la opción /preview.
Para obtener más información sobre cómo encontrar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
Efectos de /keephistory en otras operaciones de control de versiones
Si especifica la opción /keephistory para conservar el historial de archivos destruidos, los archivos se tratan como destruidos en las siguientes operaciones de Control de versiones de Team Foundation:
Cambiar contenido Si intenta cambiar el contenido de un archivo destruido (por ejemplo, lo modifica o lo bifurca), el sistema emite un mensaje de error en el que se indica que el contenido se ha destruido.
Bifurcar, combinar o retomar cambios aplazados Si intenta bifurcar, combinar o retomar cambios aplazados de elementos destruidos, el sistema emite un mensaje de error en el que se indica que el contenido de los elementos se ha destruido.
Destruir elementos previamente eliminados
Si ya se ha eliminado un elemento, se asocia un identificador de eliminación al elemento y se produce un cambio de nombre de archivo.
Ejemplos
Description
En el ejemplo siguiente se elimina permanentemente el archivo a.cs.
Código
C:\pi\ws1>tf destroy $/proj/pi/a.cs
Description
En el ejemplo siguiente se elimina una carpeta, aFolder; para ello, escriba lo siguiente en la línea de comandos:
Código
C:\tf delete $/MyTeamProject/aFolder
Description
Para destruir el elemento eliminado, aFolder, debe escribir lo siguiente en la línea de comandos:
Código
tf destroy $/MyTeamProject/sFolder;x123
Donde x123 es el identificador de eliminación.
Vea también
Tareas
Cómo: Destruir archivos bajo control de versiones
Conceptos
Operaciones disponibles sólo desde la línea de comandos (Control de versiones de Team Foundation)