Quitar elementos de trabajo permanentemente [witadmin]
Puede eliminar de forma permanente uno o varios elementos de trabajo de la base de datos de Team Foundation de una colección de proyectos de equipo mediante el comando witadmin destroywi. Los elementos de trabajo que tienen su estado establecido en Cerrado permanecen en la base de datos y se pueden reactivar. Los elementos de trabajo eliminados de forma permanente se quitan de la base de datos y no se pueden restaurar ni reactivar.
Cada elemento de trabajo representa un objeto que se almacena en la base de datos de Team Foundation y al que se asigna un identificador único, que recibe el nombre de identificador de elemento de trabajo. Los identificadores de elementos de trabajo de una misma colección de proyectos son únicos.
La herramienta de línea de comandos witadmin solo funciona cuando se ejecuta en una implementación local de TFS. Para ejecutar la herramienta, abra una ventana del símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por %programfiles%.
Requisitos
- Debe ser miembro de los grupos de seguridad Administradores de Team Foundation o Administradores de proyectos de la colección de proyectos de equipo. Consultar Referencia de permisos para Team Foundation Server
Nota
Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008.Para abrir una ventana del símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual de Símbolo del sistema y, a continuación, elija Ejecutar como administrador.Para obtener más información, vea el sitio web de Microsoft.
witadmin destroywi /collection:CollectionURL /id:id [/noprompt]
Parámetros
Parámetro |
Descripción |
|---|---|
/collection:CollectionURL |
Especifica el URI de la colección de proyectos de equipo. El formato del URI es el siguiente: http://NombreDeServidor:Puerto/NombreDeDirectorioVirtual/NombreDeColección Si no se usa ningún directorio virtual, el formato del identificador URI será el siguiente: http://NombreDeServidor:Puerto/NombreDeColección. |
/id:id |
El identificador de un elemento de trabajo que se quiera destruir. Para especificar varios elementos de trabajo, separe los identificadores únicamente mediante comas, sin usar espacios. |
/noprompt |
Inhabilita la solicitud de confirmación. |
/? o help |
Muestra ayuda sobre el comando en la ventana del símbolo del sistema. |
Ejemplos
Eliminar elementos de trabajo de la base de datos de forma permanente
En el siguiente ejemplo se muestra cómo se elimina el elemento de trabajo 2003 de la base de datos de la colección Collection1 del servidor AdventureWorksServer:
witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:2003
En el siguiente ejemplo se muestra cómo se eliminan los elementos de trabajo con los identificadores 12, 15 y 23 de la base de datos de la colección Collection1 del servidor AdventureWorksServer:
witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:12,15,23
Vea también
Conceptos
Usar los elementos de trabajo para administrar un proyecto
Otros recursos
witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo