Modify a Team Project Collection

Article
02/04/2013

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.
Reporting: 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

Open the administration console for Team Foundation.

For more information, see Open the Team Foundation Administration Console.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection that you want to stop or start.
In General, click Stop Project Collection or Start Project Collection.

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

Note

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

To edit the description of a team project collection

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection whose description you want to edit.
In General, click Edit Description.
In Edit Team Project Collection Description, update the text, and then click OK.

To manage membership in groups for team project collections

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to administer membership.
In General, click Administer Group Membership.
In Global Groups, perform one of the following steps:
- To add a group, click New, and follow the instructions in Create a Collection-Level Group.
- To add users to or remove users from a group, click Properties, and follow the instructions in Add Users to a Collection-Level Group or Remove Users from a Collection-Level Group.
- To remove a group, click Remove, and follow the instructions in Remove a Collection-Level Group.
- To rename a collection-level group, click Properties, and follow the instructions in Rename a Collection-Level Group.

To manage permissions for users and groups in the collection

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to administer permissions.
In General, click Administer Security.
In Global Security, click 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

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to view the status.
In Status, review the information in Most Recent Servicing Activity.
To view the log, click the link under The log has been saved to the following location.

Displaying Information About Team Projects

To display a list of team projects in a collection

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to display a list of team projects.
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

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to display the default location where team project portals will be created.
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

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to change the default location where team project portals will be created.
In SharePoint Site, click Edit Default Site Location.
In Edit Default Site Location, perform one of the following steps:
- If you want to specify a different SharePoint Web application, click an application in the SharePoint Web Application list, and then type the relative path for an existing root site or site collection.
  
  Note
  
  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, type the relative path for an existing root site or site collection.
In Full Path, review the information, and click OK if it is correct.

To remove the default location for team project portals

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to remove the default location.
In SharePoint Site, click Clear Configuration.

Important

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

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to display information.
In Reporting, review the information in Current Default Site Location.

To add or change the root folder for report subfolders

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to add or change the default root folder.

Important

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.
In Reporting, click Edit Default Site Location.
In Edit Default Site Location, type a path or folder name in Existing path on the Reporting Services Server, and then click OK.

Note

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

Open the administration console for Team Foundation.
Under Team Foundation, expand the name of the server, expand Application Tier, and click Team Project Collections.
In Team Project Collections, click the collection for which you want to remove the default location.
In Reporting, click Clear Configuration, and then click OK.

Important

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, click Cancel.