Destroy (Comando, Control de versiones de Team Foundation)

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 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.

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] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]

Parámetros

Opción	Descripción
/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. 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 Visual Studio 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.
/silent	Especifica que, al destruir archivos o carpetas, el resultado no se escribe en la ventana del símbolo del sistema.
/login	Especifica el nombre de usuario y la contraseña para autenticar al usuario con Team Foundation Server.
/collection	Especifica la colección del proyecto de equipo.

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

Descripción

En el ejemplo siguiente se elimina permanentemente el archivo a.cs.

Código

C:\pi\ws1>tf destroy $/proj/pi/a.cs

Descripción

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

Descripción

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

Destruir archivos bajo control de versiones

Conceptos

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

Otros recursos

Comandos de la utilidad Tf de la línea de comandos