Share via

Create a Team Project

You can create a team project that will provide a central point for your team to share team activities that are required to develop a specific software technology or product. You can provide this central point by using the New Team Project Wizard to create a team project. You can create a team project only from Team Explorer and after you have connected to the team project collection where the new team project that you want will be created.


Before you create a team project, review Launching a New Team Project and Configuring Resources to Support Team Projects to make sure that all the resources that your team project requires are configured.

In this topic

  • Creating a Team Project

  • Troubleshooting Team Project Creation

Required Permissions

To perform this procedure, you must be a member of the following security groups:

  • For the project collection on the application tier for Team Foundation: Team Foundation Administrators or Project Administrators group and your Create new projects permission must be set to Allow.

  • On the server that will host SharePoint Products for your team project: the appropriate groups in SharePoint Central Administration. These groups vary depending on your version of SharePoint Products.

    If the portal site is being creating under a site collection for the team project collection, you must have Full Control permissions set for the site collection. If the project site is created as a site collection itself, you must have farm administrator permissions.

    For more information, see Set Administrator Permissions for Team Project Collections.

  • On the server that will host SQL Server Reporting Services for your team project: Team Foundation Content Managers group.

For more information, see Set Administrator Permissions for Team Project Collections.

Creating a Team Project


The process template that you select when you run the wizard determines which pages the wizard displays. The following procedure uses the MSF for Agile Software Development process. You might see different pages if you select a different process template.

To connect to a team project collection

  1. Click Start, point to All Programs, point to Microsoft Visual Studio 2010, and then click Microsoft Visual Studio 2010.


    If you are running Team Explorer from a server that hosts SharePoint Products and SQL Server Reporting Services, you may need to run Visual Studio as an administrator.

  2. On the Team menu, click Connect to Team Foundation Server.

    The Connect to Team Project dialog box appears.

  3. In the Team Foundation Server list, click a server that is running Visual Studio Team Foundation Server.

  4. In the Connect to Team Project dialog box, select from the Team Foundation Server list the server that contains the team project collection to which you want to add your team project.


    If the drop-down list is empty, click the Servers button to manually enter the server connection settings. Contact your Team Foundation administrator or team project administrator to obtain the connection settings.

  5. Click the name of the project collection to which you want to add your team project from the Directory list.

  6. Click Connect.

To create a team project

  1. In Team Explorer, right-click the project collection, and then click New Team Project.


    If you are not using the Project Management environment settings, then on the File menu, point to New, and then click Team Project.

    The New Team Project wizard appears.


    If you have not connected to a Team Foundation Server, you will be prompted to connect to one now. Review steps 1 through 5.

  2. On the Specify the Team Project Settings page, type a name for the team project that you want to create in the What is the name of the team project? box.

    You must specify a unique name that is no more than 64 characters. The name should be descriptive enough that your team members can easily associate it with the software product. Your team members will use this name to connect to the team project.

  3. (Optional) Type a description of the project in the What is the description of the team project? text box. The description is stored in Team Foundation Server and provides the site description for the optional team project portal SharePoint site.

  4. Click Next.

  5. On the Select a Process Template page, click a process template from the Which process template should be used to create the team project? list.


    If you want to use a process template that is not listed, you must first upload the template to Team Foundation Server.

  6. If you want to accept the default settings on the remaining wizard pages, click Finish. Otherwise, click Next.


    We recommend that you accept the default settings by clicking Finish. If you click Finish, you can jump to step 9.

    If you click Finish, the following tasks are performed automatically:

    • A SharePoint site for your team project is created.

    • An empty version control folder for your team project is created.

  7. Complete the Team Site Settings page:

    1. Click Create a new SharePoint site if you want to create a SharePoint site for your project.

    2. Click Configure to verify or modify the settings for your SharePoint site.

      In the Select Location to Create SharePoint Site dialog box, verify or select the URL for the Web application and the Relative site path to which you want to connect.


      You can select a Web application only if it has been added to the team project collection to which you are connected. For more information, see Add a SharePoint Web Application to Your Deployment.

      If you want a project portal name that differs from the team project name, you can type a name that is easily identified by your team members.

      The relative site path is part of the home page of the project portal.

  8. On the Specify Source Control Settings page, click one of the following options:

    • Click Create an empty source control folder to use the name of the team project for the new folder.

    • Click Create a new source control branch, and specify the folder from which you want to branch.

  9. On the Confirm Team Project Settings page, review the choices and values that you specified. If the information is correct, click Finish. Otherwise, click Previous to make changes.

    The New Team Project wizard creates your team project.


    It may take several minutes for the wizard to finish.

  10. On the Team Project Creation Status page, view the status messages and status bar for information about the components that are being created.

  11. On the Team Project Created page, if you want to read more details about the work items, roles, activities, and other aspects of the team process, select the Launch the process guidance for more information about how to run the team project check box.


    Process guidance is available only if you created or configured a SharePoint site in step 7.

  12. Click Close.

    The new team project appears in Team Explorer. If the wizard encounters a problem when creating the team project, an error message appears that states the problem and suggests corrective action. If this message appears, click View the team project creation log, and review the log for specific errors and exceptions. For more information, see Troubleshooting Team Project Creation later in this topic. 

Troubleshooting Team Project Creation

When a team project creation activity does not successfully complete, some components may be created while others are not. If so, you should determine what caused the partial creation, delete the partially created project, resolve any issues, and then create another team project.


You can gather diagnostic information about your deployment of Team Foundation Server, take a snapshot of its configuration, and obtain usage data by using the Best Practices Analyzer for Team Foundation Server. This tool performs specific checks to determine whether the deployment is configured to support the creation of a team project. For more information, see the following page on the Microsoft Web site: Team Foundation Server Power Tools.

To troubleshoot team project creation

  1. Review the information in the following table, and perform the corresponding resolution task for the symptom or error message that matches what you receive.

    Symptom or error message



    An error message indicates that you do not have permission to create a team project, connect to a server, or access a server.

    You do not have the required permissions set on one or more servers to create a team project.

    Contact the system administrators for each server that hosts Team Foundation Server, SharePoint Products, or SQL Server Reporting Services for the project collection to request the required permissions. 

    For more information, see Set Administrator Permissions for Team Project Collections.

    Error TF30169: The New Team Project Wizard was unable to download the process template {0}.

    Process templates are not available on the server that hosts SharePoint Products.

    Contact the system administrator for the server that hosts SharePoint Products and request the required process templates be the server. For more information, see Retrieve and Restore Missing Site Templates.

    Error TF30321: The name you typed is already used for another team project on the Team Foundation Server.

    The name may be in use for any of the following reasons:

    • An active project uses this name

    • A project that uses this name has been flagged for deletion but has not yet been deleted

    • A project with this name was only partially created or only partially deleted

    Try again using a different project name.

    You may be unable to create a team project that has the same name as a team project that was deleted. Some components of the deleted team project may be scheduled for deletion but not yet deleted.

    An error message indicates a problem connecting to a server, retrieving information from a server, or checking permissions to create projects.

    A server in the Team Foundation deployment is incorrectly configured. This problem is especially common after a server move, failover, or other maintenance activity.

    Contact the system administrator for Team Foundation Server, and request that they verify the server configuration.

    An error message indicates a problem with a plug-in.

    The process template used to create the team project contains several XML plug-in files. If one of these files contains a format or other error, then an error message appears.

    Review the project creation log to determine the plug-in that caused the error. After you discover the problem, you can either contact the developer or vendor that provided the plug-in, or attempt to fix the problem yourself. For more information, see Process Template Plug-Ins.

  2. If the problem does not resolve by performing step 1, review the team project creation log and follow any instructions that are provided.

    The log shows each action taken by the wizard at the time of the failure and may include additional details about the error. To open the log:

    1. Start Notepad.

    2. On the File menu, click Open.

    3. Navigate to $:\Documents and Settings\user name\Local Settings\Temp\VSTS_TeamProjectCreation_yyyy_mm_dd_hh_mm_ss.log.

    4. Click Open.

    5. On the Edit menu, click Find.

    6. In the Find what dialog box, type Exception or Error, and then click Find Next.

    7. Review the log entries to find network or file related issues.

  3. If the problem persists, contact your Team Foundation Server administrator.

See Also


TFSDeleteProject: Deleting Team Projects


Quick Start Guide to Launching a Team Project

Other Resources

Configuring Resources to Support Team Projects

Launching a New Team Project