Mapping/Unmapping Command for Team Foundation Server and Project Server Integration

  • Article

 

From a Developer command prompt with the right credentials: 

 

tfsadminprojectServer /RegisterPwa /pwa:<PWA_URL> /tfs:<TFS_URL> 

 

Registering PWA <PWA_URL> 

 

................................................... 

You have successfully registered PWA <PWA_URL>. 

 

Wait a few minutes before running another provisioning command while background processes complete. 

 

tfsadminprojectServer /GetRegisteredPwa /tfs:<TFS_URL> 

 

The following PWA instances are registered: 

 

<PWA_URL_1> 

  

TfsAdmin.exe projectServer /MapPwaToCollection /pwa:<PWA_URL> /collection:<TFS_URL>/<TFS_COLLECTION_NAME> 

Mapping team project collection <TFS_URL>/<TFS_COLLECTION_NAME> to PWA <PWA_URL>. 

 .................................................. 

You have successfully mapped team project collection <TFS_URL>/<TFS_COLLECTION_NAME> to PWA <PWA_URL>. 

 

TfsAdminProjectServer /GetMappedCollections /tfs:<TFS_URL>/<TFS_COLLECTION_NAME> 

.. 

The following collections are mapped: 

Collection <TFS_URL>/<TFS_COLLECTION_NAME> is mapped to PWA <PWA_URL>. 

 

 

TfsAdminProjectServer /UploadFieldMappings /collection:<TFS_URL>/<TFS_COLLECTION_NAME> /useDefaultFieldMappings 

 

 

Uploading field mappings to team project collection <TFS_URL>/<TFS_COLLECTION_NAME> . 

 

....... 

You have uploaded field mappings to team project collection <TFS_URL>/<TFS_COLLECTION_NAME> . 

 

 

TfsAdminProjectServer /MapPlanToTeamProject /collection:<TFS_URL>/<TFS_COLLECTION_NAME> /enterpriseProject:<PS_ENTERPRISE_PROJECT_NAME> /teamProject:<TFS_TEAM_PROJECT> /workItemTypes:"User Story, Task" 

 

Mapping enterprise project <PS_ENTERPRISE_PROJECT_NAME> to team project <TFS_TEAM_PROJECT>. 

 

.............. 

You have successfully mapped enterprise project <PS_ENTERPRISE_PROJECT_NAME> to team project <TFS_TEAM_PROJECT>. 

 

 

UnMapping Commands 

 

TfsAdminProjectServer /unMapPlanFromTeamProject /collection:<TFS_URL>/<TFS_COLLECTION_NAME> /enterpriseProject:<PS_ENTERPRISE_PROJECT_NAME> /teamProject:<TFS_TEAM_PROJECT> 

  

Unmapping enterprise project <PS_ENTERPRISE_PROJECT_NAME> from team project <TFS_TEAM_PROJECT>. 

  

  

.......................................................... 

Enterprise project <PS_ENTERPRISE_PROJECT_NAME> was successfully unmapped from team project <TFS_TEAM_PROJECT>. 

  

  

TfsAdmin.exe projectServer /unMapPwaFromCollection /pwa:<PWA_URL> /collection: <TFS_URL>/<TFS_COLLECTION_NAME> 

  

Unmapping team project collection <TFS_URL>/<TFS_COLLECTION_NAME> from PWA <PWA_URL>. 

  

.... 

You have successfully unmapped team project collection <TFS_URL>/<TFS_COLLECTION_NAME> from PWA <PWA_URL>. 

  

  

tfsadminprojectServer /unRegisterPwa /pwa:<PWA_URL> /tfs: <TFS_URL> 

  

Unregistering PWA <PWA_URL>. 

  

........................................ 

You have successfully unregistered PWA <PWA_URL>. 

  

Wait a few minutes before running another provisioning command while background processes complete. Hope this will help in troubleshooting integration issues as I have used it with many customers.

Written by: Nitish Nagpal, Support Escalation Engineer

Reviewed by: Puvi Pandian, TFS/Project Server Integration Team