There is no easy way to rename a TFS 2013 project collection. I had to go through the exercise on my current project so I thought I’d share on how to do it.

Here are the steps with screenshots: 

1. Login to your TFS 2013 server and open up the Team Foundation Server Administration Console.

2. Select the project collection that you wish to rename.

3. Click on the “Stop Collection” from the General tab.

tfs1

 4. Enter the reason for stopping the collection.

 5. Click on the “Detach Collection” from the General tab. Follow through to the screenshots below until the collection is detached.

tfs3

tfs4

tfs5

tfs6

tfs8

 6. Review any warnings. Below are my warnings, nothing major so OK to move on.

  • This collection has SQL Enterprise features enabled. If you are moving the collection across SQL Server Editions please read the documentation (http://go.microsoft.com/fwlink/?LinkId=166007) to see how this impacts you.
  • Some build resources are enabled. If any builds are running during the servicing operation, they will be stopped by the system.

tfs9 

7. Backup and restore your project collection database. See this blog for instructions.

8. Refresh your TFS 2013 administration console. Click on the “Attach Collection” and choose the newly restored database.

tfs27

tfs28

 9. Enter the name of the project collection. Typically this should match your database name you used in step 7 without the prefix. Follow through the screenshots and you are done!

tfs29

tfs30

tfs31

tfs32

tfs33

tfs34

Enjoy!

Like this post? Share it!