Delete a Team Project

You can reduce the complexity of a team project and simplify the navigation for users by deleting team projects from that team project collection that are no longer used. Before you delete a project, you should make sure that it and its associated data will not be needed. Deleting a team project will remove the data for the project from the collection database in SQL Server. If the project used reporting, you will also have the option to remove reports and reporting data when you delete the project. If the project had a team project portal, all references to that portal will be removed, but the SharePoint site or Web site that acted as the portal will not be deleted. If you want to delete the portal, you must do so manually after the project has been deleted.

Deleting a team project can be done from the administration console for Team Foundation. It can also be done from the command line, but the process is significantly different, and what will be removed is also different. For more information about the command-line process, see TFSDeleteProject: Deleting Team Projects.

Required Permissions

To perform these procedures, you must belong to the following groups or have the following permissions:

  • Team Foundation Administrators group or your View instance-level information and Edit instance-level information permissions must be set to Allow

  • If you want to remove reporting for this project from SQL Server Reporting Services, the Team Foundation Content Managers group or the System Administrators group


    To perform administrative tasks such as deleting team projects, your user account requires administrative permissions, and the service account that the Team Foundation Background Job Agent uses must also have certain permissions granted to it. For more information, see Service Accounts and Dependencies in Team Foundation Server and Team Foundation Background Job Agent.

For more information about permissions, see Team Foundation Server Permissions.

In addition to these permissions, you might need to address the following requirements on a computer that is running Windows Server 2008 or Windows Vista:

  • To follow a procedure that requires Internet Explorer, you might need to start it as an administrator by clicking Start, clicking All Programs, right-clicking Internet Explorer, and then clicking Run as administrator.

  • To access Report Manager, reports, or Web sites for Reporting Services, you might need to add these sites to the list of trusted sites in Internet Explorer or start Internet Explorer as an administrator.

For more information, see this topic on the Microsoft Web site: User Account Control.

To delete a team project from the administration console

  1. Open the administration console for Team Foundation.

    For more information, see Open the Team Foundation Administration Console.

  2. Expand the server, and then click Team Project Collections.

  3. In Team Project Collections, click the collection that contains the project that you want to delete, and then click the Team Projects tab.

  4. In Team Projects, click the project that you want to delete, and then click Delete.

    The Delete Team Projects window opens.

  5. (Optional) In Delete Team Projects, select one or both of the following check boxes.

    • To remove data for this team project from Reporting Services and Visual Studio Lab Management, select the Delete external artifacts check box.

    • To remove any workspaces that are associated with this team project, select the Delete workspace data check box.

  6. In Delete Team Projects, click Delete.

    The Delete Team Projects window closes.

  7. On the Team Projects tab, review the state of the team project.

    The status shows Deleted, with additional information about the state of the deletion in parentheses.

    • (Processing) means that the process has started and is in progress.

    • (Pending) means that the deletion process has started from a client application. The deletion might be in progress or might have failed. Because the process was started from a client application, the server cannot accurately report the status of the deletion. If a project deletion remains pending for a long time, try to delete the project again from the administration console.

    • (Failed) means that the deletion process started but did not complete successfully. The log file will contain specific information about the failure. Review the information about the failure, and then try to delete the project again.

  8. (Optional) Review information about the deletion in the log file, under the Logs section in the console.

See Also


Create a Team Project

Other Resources

Move a Team Project Collection

Split a Team Project Collection