Modify a Team Project Collection

Visual Studio Team Foundation Server 2012

You can support physical and organizational changes in your business infrastructure by modifying the settings for your team project collections. For example, you can stop a collection before you perform an operation such as backing up its data or applying a service pack to the server on which a collection resides. You can then restart the collection after you complete the operation. You can change the users who have access to the collection, their permissions, and the resources that are allocated for the collection in SharePoint Products and SQL Server Reporting Services. You can modify all settings for collections in the administration console for Team Foundation.

You can find information about a team project collection on the following tabs:

  • General: Displays the name and the uniform resource indicator (URI) of the collection. From this tab, you can also stop or start the collection, view or edit the description of the collection, and administer the group membership and permissions for users and groups in the collection.

  • Status: Displays the status of the collection. From this tab, you can also open a log file that provides details about the collection status.

  • Team Projects: Displays the list of team projects that the collection contains. On this tab, you can also review any descriptions of team projects that were included.

  • SharePoint Site: Displays the URI of the site under which Web sites will be created by default for all team projects that are created in the collection. If you create or modify a team project, you can specify a different site, but this root site will be used as the default. From this tab, you can also change the default location for creating team project portals and add or remove the configuration.

  • Reports Folder: Displays the path under which report folders will be created by default. These folders will store the reports for team projects that are created in this collection. If you create or modify a team project, you can specify another folder, but this root path will be used as the default. On this tab, you can also change the default location and remove the configuration.

Required Permissions

To perform these procedures, you must either have the following permissions or be a member of the following groups:

  • The View Instance-Level Information and Edit Instance-Level Information permissions set to Allow or a member of the Team Foundation Administrators group

  • If you want to modify settings for SQL Server Reporting Services or SharePoint Products, the service account for Team Foundation Server and that is used by the Team Foundation Background Job Agent must have appropriate permissions on the instance of SQL Server or the SharePoint Web application. 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.

Managing General Settings

To stop or start a team project collection

  1. Open the administration console for Team Foundation.

    For more information, see

Open the Team Foundation Administration Console.

  • Expand the name of the server, expand Application Tier, and choose Team Project Collections.

  • In Team Project Collections, highlight the collection that you want to stop or start.

  • In General, choose Stop Collection or Start Collection.

    If the project collection is started, only Stop Collection appears. If the project collection is stopped, only Start Collection appears.

    NoteNote

    If you stop or start a collection, the operation can take several minutes to complete. You might need to choose Refresh to display the change in state.

  • To edit the description of a team project collection

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection whose description you want to edit.

    4. In General, choose Edit Settings.

    5. In Edit Team Project Collection Settings, update the text, and then choose OK.

    To manage membership in groups for team project collections

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to administer membership.

    4. In General, choose Group Membership.

    5. In Global Groups, perform one of the following steps:

      • To add a group, choose New, and provide the required information.

      • To add users to or remove users from a group, highlight that group, choose Properties, and either choose Add, or highlight the user or group you want to remove and choose Remove.

      • To remove a group, choose Remove. This option is only available for groups that you added.

      • To rename a collection-level group, highlight it, choose Properties, and specify a different name.

    To manage permissions for users and groups in the collection

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to administer permissions.

    4. In General, choose Administer Security.

    5. In Global Security, highlight the user or group for whom you want to administer permissions, and then select the appropriate Allow or Deny check boxes.

      For more information, see Team Foundation Server Permissions and Team Foundation Server Default Groups, Permissions, and Roles.

    Displaying Status Information

    To display the status and the log file for a team project collection

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to view the status, and then choose the Status tab.

    4. In Status, review the information in Most Recent Servicing Activity.

    5. To view the log, either double-click it in the list, or highlight it and then choose Enter.

    Displaying Information About Team Projects

    To display a list of team projects in a collection

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to display a list of team projects.

    4. In Team Projects, review the list of projects and their descriptions, if any.

    Managing Settings for SharePoint Sites

    To display the default root location for team project portals

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to display the default location where team project portals will be created.

    4. In SharePoint Site, review the information in Current Default Site Location.

    To add or change a default root location for creation of team project portals

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to change the default location where team project portals will be created.

    4. In SharePoint Site, choose Edit Default Site Location.

    5. In Edit Default Site Location, perform one of the following steps:

      • If you want to specify a different SharePoint web application, choose an application in the SharePoint Web Application list, and then specify the relative path for an existing root site or site collection.

        NoteNote

        If the SharePoint Web Application list is empty, no applications have been configured for use by Team Foundation Server. For more information, see

    Add a SharePoint Web Application to Your Deployment.
  • If you do not want to change the web application, specify the relative path for an existing root site or site collection.

  • In Full Path, review the information, and choose OK if it is correct.

  • To remove the default location for team project portals

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to remove the default location.

    4. In SharePoint Site, choose Clear Configuration.

      Important noteImportant

      By removing the configuration, you are removing the default location in which the Create New Team Project Wizard will create team project portals. However, you are not removing the site itself or any team project portals that already exist under it. Project administrators can still create a team project portal, but they must specify a location for it.

    Managing Settings for Reporting

    To view the root folder for report subfolders

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to display information.

    4. In Reports Folder, review the information in Current Default Folder Location.

    To add or change the root folder for report subfolders

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to add or change the default root folder.

      Important noteImportant

      In this release, you cannot add a report server after the installation and initial configuration of Team Foundation Server. If you did not add a report server at that time, you cannot add a folder for storing reports.

    4. In Reports Folder, choose Edit Default Folder Location.

    5. In Edit Default Folder Location, specify a path or folder name in Folder path on the Reporting Services Server, and then choose OK.

      NoteNote

      This operation will fail if you type the path of a folder that does not exist on the server and you do not have permission to create a folder on that server. You must specify an existing folder if you do not have permissions to create folders on that server.

    To remove the default location for report subfolders

    1. Open the administration console for Team Foundation.

    2. Expand the name of the server, expand Application Tier, and choose Team Project Collections.

    3. In Team Project Collections, highlight the collection for which you want to remove the default location.

    4. In Reports Folder, choose Clear Configuration, and then choose OK.

      Important noteImportant

      By removing the configuration, you are removing the reporting functionality for all existing and future team projects in this collection. This change can significantly impact the functionality of all team projects in this collection. If you are not sure whether you want to make this change, choose Cancel.

    See Also

    Tasks

    Create a Team Project Collection

    Concepts

    Other Resources