How to rename a TFS collection

Author: Romit Gulati                                                                                                                       Reviewed by: Lakhminder Singh

After following this article we will be able to rename an existing TFS collection. In this scenario we will be renaming a collection name ‘Collection3’ to ‘CollectionNew’

Following is a snapshot of our collection ‘Collection3’ with a Project name’ Test Project’.

clip_image001

To achieve this goal we need to follow a three step process done in the TFS Administration Console

Stop the collection > Rename the collection > Start the collection

Stop a Collection

Launch TFS Administration Console and select ‘Team Project Collection’ Node on left side under Application Tier.

clip_image003

Select the collection that we want to rename (Collection3 in our case), and click on ‘Stop Collection’

clip_image005

Give a status (reason) for stopping the collection and then select ‘Stop’.

clip_image006

Now the stopped Collection will appear as ‘Offline’

clip_image007

Now click on Edit Settings

clip_image009

This will display the ‘Edit Team Project Collection Settings’ window. Change the name of the collection as CollectionNew. The SQL Server Instance and Database name should remain as how it is since are not changing them.

clip_image010

(after editing)

clip_image011

Once we save the settings, we will see the collection with new name (CollectionNew) although it is still in offline mode.

Note that description is also shown below

clip_image013

Now all that we need to do is to start the collection

clip_image015

Once we start the collection it will be in ‘Online’ mode and ready to be used

clip_image016

Now we see our renamed collection

clip_image017

clip_image018

Please Note:

The above steps will only rename the Name of the collection, other components like SQL Database, WSS, SSRS remain the same.

For example: when you browse team portal for Test Project it would still be pointing to Collection3

https://server1/sites/collection3/test in our case.

This is same for reports also

clip_image019