Eliminar un proyecto de equipo

Artículo
02/20/2013

Puede quitar un proyecto de equipo de Team Foundation Server cuando el proyecto ya no se requiere utilizando TFSDeleteProject.Además, si hay componentes que siguen sin ser eliminados después de una creación del proyecto de equipo incorrecta, puede utilizar TFSDeleteProject para quitarlos.

Importante
TFSDeleteProject destruye permanentemente el proyecto de equipo, después de que no se puede recuperar.Debería hacer una copia de seguridad de todos los datos importantes del proyecto antes de utilizar TFSDeleteProject.

Para obtener acceso a la herramienta de la línea de comandos TFSDeleteProject, abra una ventana de símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

En una edición de 64 bits de Windows, reemplace %programfiles% con %programfiles(x86)%.

[!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 de símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador.Para obtener más información, vea el sitio web de Microsoft: Control de cuentas de usuario.

Permisos necesarios

Para utilizar el comando TFSDeleteProject, debe ser miembro del grupo de seguridad Administradores de Team Foundation o del grupo de seguridad Project Administrators.Para obtener más información, vea Permisos de Team Foundation Server y Grupos predeterminados, permisos y roles de Team Foundation Server.

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

Parámetros

Opción	Descripción
/q	Opcional.Utiliza el modo no interactivo.No solicite confirmación por parte del usuario.
/force	Opcional.Especifica que el proceso de eliminación debería continuar aun cuando no se pueden eliminar algunos componentes.
/excludewss	Opcional.Especifica no eliminar el sitio de SharePoint que está asociado al proyecto de equipo.Especifique esta opción para mantener el sitio existente para que otros proyectos de equipo puedan seguir utilizándolo.
/collection:URL	Requerido.Especifica el URI de la colección de proyectos de equipo.Debe usar el siguiente formato para el identificador URI: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Si no especifica un directorio virtual, debe utilizar el formato siguiente para el URI: http://NombreServidor:Puerto/NombreColección.
TeamProjectName	Requerido.Nombre del proyecto.Si el nombre incluye espacios, enciérrelo entre comillas.

Comentarios

Al crear un proyecto de equipo, Team Foundation Server crea objetos de datos en el servidor que hospeda Team Foundation Server, y puede crear objetos de datos en el servidor que hospeda Productos de SharePoint, y el servidor que hospeda SQL Server Reporting Services.Al quitar un proyecto de equipo, los informes se quitan automáticamente de SQL Server Reporting Services.

Al quitar un proyecto de equipo, puede decidir si desea quitar o no los objetos que se crearon para admitir el sitio de SharePoint.Sin embargo, un error puede impedir que Team Foundation Server cree o elimine todos los objetos.Para solucionar estos problemas, las secciones siguientes proporcionan información general, vínculos a otros recursos y pasos concretos que le ayudan a determinar la causa del problema, corregir el problema y cuando sea necesario eliminar los objetos de datos que permanecen después de ejecutar TFSDeleteProject.

TFSDeleteProject (Proceso)
Datos que pueden permanecer sin ser eliminados
Comprobar que se eliminan los componentes del proyecto de equipo
Quitar los componentes restantes después de la eliminación parcial del proyecto
Aumentar el tiempo de espera

TFSDeleteProject (Proceso)

Al utilizar la herramienta de la línea de comandos TFSDeleteProject, primero elimina los datos del proyecto y, a continuación, los sitios web del proyecto.

Fase 1: TFSDeleteProject elimina los datos del proyecto

En la primera fase, TFSDeleteProject sigue automáticamente estos pasos para quitar los datos del proyecto de equipo:

TFSDeleteProject crea un inventario de todos los componentes que son candidatos para la eliminación.Esto incluye componentes que se integran con Test Manager, Team Foundation Build y control de versiones de Team Foundation.
TFSDeleteProject elimina el componente que muestra el nodo de proyecto en Team Explorer.
TFSDeleteProject marca la información del control de versiones para su eliminación, pero no elimina esta información inmediatamente.La información incluye todas las bifurcaciones del control de versiones en el proyecto especificado, pero ninguna otra bifurcación fuera del proyecto.
- Si una bifurcación primaria y una bifurcación secundaria están en el proyecto, TFSDeleteProject marca ambas para su eliminación.
- Si las bifurcaciones primarias y secundarias están en proyectos diferentes, TFSDeleteProject solo marca la bifurcación especificada.
- Si otro proyecto es una bifurcación del proyecto especificado, TFSDeleteProject solo marca el proyecto especificado.Cuando se elimina el proyecto especificado, el proyecto de bifurcación se vuelve huérfano.
TFSDeleteProject elimina inmediatamente los datos de compilación, incluida la información y datos básicos, definiciones de compilación, agentes de compilación y resultados de pruebas asociados al proyecto de equipo.La herramienta no elimina las ubicaciones de destino de la compilación.No necesita eliminar la ubicación de destino de compilación de un proyecto de equipo anterior antes de crear un proyecto de equipo que utilice la misma ubicación de destino de compilación.

Si el proyecto especificado contiene una cantidad grande de datos de compilación, la eliminación podría no finalizar dentro del período de tiempo de espera.Para resolver este problema, vea Aumentar el tiempo de espera y, a continuación, ejecute TFSDeleteProject de nuevo.
TFSDeleteProject elimina inmediatamente los elementos de trabajo y campos del elemento de trabajo que pertenecen al proyecto especificado, y elimina todos los metadatos no compartidos.

Si el proyecto especificado contiene una cantidad grande de datos del elemento de trabajo, la eliminación podría no finalizar dentro del período de tiempo de espera.Para resolver este problema, vea Aumentar el tiempo de espera y, a continuación, ejecute TFSDeleteProject de nuevo.

Fase 2: TFSDeleteProject elimina los sitios web del proyecto

En la segunda fase, TFSDeleteProject elimina los datos siguientes:

Importante
Estos pasos pueden tardar mucho tiempo en completarse, y durante ese tiempo pueden degradar el rendimiento del servidor.

TFSDeleteProject utiliza las API de Reporting Services para eliminar los informes en el servidor que hospeda Reporting Services.
TFSDeleteProject elimina el sitio web del portal del proyecto del servidor que hospeda Productos de SharePoint.Este paso solo se produce si el proyecto posee el sitio y la eliminación del sitio no se excluye en la línea de comandos.(tenga en cuenta que varios proyectos pueden señalar a un único sitio, pero solo uno de ellos puede ser el propietario donde los informes/paneles utilicen este proyecto de forma predeterminada).

[!NOTA]

Antes de eliminar un proyecto de equipo, puede confirmar que Reporting Services y Productos de SharePoint están utilizando las direcciones URL del proyecto correctas comprobando los valores del portal.Para obtener más información, vea How to: Add a Team Project Portal.

Si TFSDeleteProject elimina todos los elementos de datos anteriores correctamente, devuelve el mensaje Hecho.Para comprobar este resultado, vea Comprobar que se han eliminado los componentes del proyecto de equipo.

Si no se quitan uno o más componentes, puede volver a ejecutar TFSProjectDelete utilizando la opción /force para continuar el proceso de eliminación aun cuando no pueda eliminar todos los elementos de datos.Con esta opción, TFSDeleteProject omite un componente que no puede eliminar, devuelve un mensaje de error, elimina el componente siguiente y deja intactos los metadatos del proyecto de equipo y la configuración de seguridad.

Datos que pueden permanecer sin ser eliminados

Los datos siguientes podrían permanecer en la implementación después de que TFSDeleteProject se completa correctamente:

Datos del proyecto de equipo en el cubo.Los datos del proyecto de equipo permanecen en el cubo hasta que este se recompila, en cuyo momento, el servicio de controlador de almacén quita todos los datos históricos de la compilación eliminados de las bases de datos de Team Foundation.
Archivos y carpetas de entrega de la compilación.Los archivos binarios de compilación, los archivos de registro de compilación y los archivos de registro que contienen resultados de pruebas se publican durante el proceso de compilación.No se eliminan las ubicaciones de estos archivos.Si desea quitar estos archivos, debe hacerlo manualmente.
Metadatos de seguimiento de elementos de trabajo que se comparten.TFSDeleteProject no elimina ningún metadato para el seguimiento de elementos de trabajo que se comparta entre los proyectos de equipo.
Conjuntos de cambios aplazados de control de versiones que contienen código compartido.Los conjuntos de cambios aplazados de control de versiones no se eliminan si hay código en el conjunto de cambios aplazados de varios proyectos de equipo.

Comprobar la eliminación del proyecto

Puede comprobar el éxito de la eliminación de un proyecto confirmando que el nodo del proyecto de equipo ya no aparece en Team Explorer y que ya no existe su sitio web del portal del proyecto y las carpetas de informes.

Para comprobar que se ha eliminado correctamente un proyecto de equipo

Abra Team Explorer y compruebe que el proyecto no aparece como un nodo de proyecto.
Abra Internet Explorer y escriba la dirección URL del sitio web del portal del proyecto.Compruebe que el sitio ya no existe.
En Internet Explorer, en el cuadro Dirección, escriba la dirección URL del sitio web de Reporting Services utilizando uno de los formatos de dirección URL siguientes:
- http://ReportingServices/Reports
- **http://ReportingServices/Reports_**InstanciaTFS
En el Administrador de informes, haga clic en Mostrar detalles.
Compruebe que la carpeta del proyecto de equipo eliminado ya no aparece.Haga clic en la carpeta raíz TfsReports y, a continuación, haga clic en la carpeta especificada para la colección de proyectos de equipo.No debería haber ya una carpeta con el nombre del proyecto eliminado.
Si los informes o el sitio web permanecen, vea el procedimiento siguiente.

Quitar los componentes restantes después de la eliminación parcial del proyecto

Si el sitio web del portal del proyecto y la carpeta de informes permanecen después de eliminar un proyecto de equipo, quite el sitio y la carpeta manualmente.

Para quitar manualmente los informes y el sitio web del portal del proyecto de un proyecto de equipo eliminado

Inicie sesión en el servidor que hospeda Reporting Services para el proyecto de equipo que eliminó.
Abra Internet Explorer, y en el cuadro Dirección, escriba la dirección URL del sitio web de Reporting Services utilizando uno de los formatos de dirección URL siguientes:
- https://localhost/Reports
- **https://localhost/Reports_**InstanciaTFS
En el Administrador de informes, haga clic en Mostrar detalles.
Haga clic en la carpeta raíz TfsReports y, a continuación, haga clic en la carpeta especificada para la colección de proyectos de equipo.
Active la casilla del proyecto de equipo que se eliminó.
Haga clic en Eliminar.
Haga clic en Aceptar para confirmar que desea eliminar la carpeta de informes del proyecto de equipo.
Para quitar el sitio web del portal del proyecto de un proyecto de equipo eliminado, vea la página siguiente en el sitio web de Microsoft: Cómo: Crear, editar y eliminar sitios de Windows SharePoint Services.

Aumentar el tiempo de espera

De forma predeterminada, cada llamada al servicio Web que emite el comando TFSDeleteProject para eliminar un componente se debe completar en 10 minutos.Si hay seis llamadas, el proceso podría tardar hasta una hora.Si desea eliminar un proyecto de equipo que está asociado a una cantidad grande de datos, puede aumentar este tiempo de espera temporalmente.

[!NOTA]

Al aumentar el tiempo de espera, el cambio afecta a todas las llamadas al servicio Web.En general, conviene mantener el tiempo de espera en 10 minutos para evitar que las llamadas al servicio Web degraden el rendimiento del servidor e impidan a los usuarios utilizar la interfaz de usuario durante períodos largos de tiempo.Por consiguiente, una vez eliminado correctamente el proyecto, debería volver a establecer el tiempo de espera en 10 minutos.

Permisos necesarios

Para completar estos procedimientos, debe ser administrador de Windows en el servidor de capa de datos de aplicación.

Importante
Modificar incorrectamente el Registro de su equipo puede hacer que éste se vuelva inestable.Si no está familiarizado con el Registro, no debería agregar ni quitar entradas ni modificarlo de ninguna forma.

Para aumentar el tiempo de espera para el comando TFSDeleteProject

Inicie sesión en el servidor de capa de aplicación.
Haga clic en Inicio y en Ejecutar, escriba regedit y, a continuación, haga clic en Aceptar.
En el panel del explorador, expanda HKEY_ LOCAL_MACHINE:
- Si el servidor ejecuta un sistema operativo de 32 bits, expanda: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.
- Si el servidor ejecuta un sistema operativo de 64 bits, expanda: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.
Si la clave TeamFoundation\RequestSettings no existe, siga estos pasos para crearla:
1. Haga clic con el botón secundario en TeamFoundation, elija Nueva y haga clic en Clave.
2. Denomine la clave RequestSettings.
3. Haga clic con el botón secundario en RequestSettings, elija Nuevo y haga clic en Valor DWORD.
4. Denomine el nuevo valor DefaultTimeout.
Haga clic con el botón secundario en DefaultTimeout y elija Modificar.
En Información del valor, escriba el tiempo de espera en milisegundos y, a continuación, haga clic en Decimal.

Por ejemplo, para aumentar el tiempo de espera a 30 minutos, escriba 1800000.Para volver a establecer el tiempo de espera a 10 minutos, escriba 600000.
Haga clic en Aceptar.
En el menú Archivo, haga clic en Salir.

Ejemplo

El comando siguiente quita todos los componentes asociados al proyecto de equipo StoreFront en el servidor AdventureWorks1 de Team Foundation Server en el proyecto de colección Collection1 y de Team Explorer.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/tfs/Collection1 StoreFront

Vea también