ConfigureConnections Command

  • Article

Use the ConfigureConnections command to change the connection interface for Team Foundation Server. 

Important noteImportant Note:

After you use the ConfigureConnections command on the server, client computers that try to connect to it will still be configured with the old settings. You must either clear the caches of these computers or instruct your users on how to clear the caches by using the procedure in the Remarks section later in this topic.

Required Permissions

To use the ConfigureConnections command, you must be a member of the Team Foundation Administrators security group on the Team Foundation application-tier server and a member of the sysadmin security group for SQL Server on the Team Foundation data-tier server. If you use the /proxy option, you must be an administrator on the application-tier and proxy servers for Team Foundation. For more information, see Team Foundation Server Permissions.

Note

Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as Administrator. For more information, see this page on the Microsoft Web site: User Account Control.

TFSAdminUtil ConfigureConnections [/View] [/proxy] [/ClientCertificate :(user|computer)] [/ATUri:<uri>] [/PublicATUri:<uri>] [/SharepointUri:<uri>] [/SharepointSitesUri:<uri>] [/SharepointAdminUri:<uri>] [/SharepointUnc:<unc>] [/ReportsUri:<uri>] [/ReportServerUri:<uri>] [/TswaUri:<uri>]

Parameters

Argument

Description

user

Use with /clientcertificate option to specify to use the user certificate store.

computer

Use with /clientcertificate option to specify it to use the computer certificate store.

URI

Use to set the uniform resource indicator (URI) with the appropriate option.

Option

Description

/view

Displays the current connection settings for Team Foundation Server.

/proxy

Runs the command for the Team Foundation Server proxy account.

If the /proxy option is used, only the /clientcertificate option may be used.

/ClientCertificate

Specifies the user or computer certificate store to which you want to add a certificate.

/ATUri

Specifies the application-tier uniform resource indicator (URI).

/PublicATUri

Specifies the URI to use in the text of e-mail alerts.

/SharepointSitesUri

Specifies the SharePoint site URI.

/SharepointAdminUri

Specifies the SharePoint administrative site URI.

/SharepointUnc

Specifies the SharePoint Uniform Naming Convention (UNC) path.

/ReportsUri

Specifies the URI for SQL Server Reporting Services. You can view the specific Team Foundation Server reports from this site.

/ReportServerUri

Specifies the URI for the ReportService.asmx Web service.

Important noteImportant Note:
If you have installed SP1 for Microsoft Visual Studio Team System 2008 Team Foundation Server, the /ReportServer parameter will not function correctly. For more information about this problem and its resolution, see this Knowledge Base article on the Microsoft Web site: Team Foundation Server 2008 SP1 TfsAdminUtil.exe 'ConfigureConnections' fails to properly set ReportServerUri.

/TswaUri

Specifies the URIs for various components of Team System Web Access, if it is installed.

Remarks

Important noteImportant Note:

We recommend that you back up the databases in the Team Foundation Server data-tier server before you run the ConfigureConnections command. It is also useful to run the command by using the /view option to first view the existing settings.

The ConfigureConnections command is used by an administrator who wants to change the configuration information, such as the server name or the port number, for one or more components of Team Foundation Server. The administrator runs this tool from the application tier to update all Team Foundation servers that have the new configuration information.

The utility updates the configuration information as follows:

  • The /ATUri option sets configuration information in the Web Services web.config file, the CoverAn.exe.config file, the TFSServerScheduler.exe.config file, and the Team Foundation database.

  • The /PublicATUri option sets configuration information in the Web Services web.config file.

  • The /ClientCertificate option opens the certificate store for the user or the computer, depending on the argument. After the user specifies a certificate to use, the information is set in the in the Web Services web.config file, the CoverAn.exe.config file, and the TFSServerScheduler.exe.config file.

  • The /SharePointUri/SharepointSitesUri, /SharePointUnc and /SharepointAdminUri options set configuration information for SharePoint Products and Technologies in the database for Team Foundation.

  • The /Reports and /ReportServer options set configuration information for SQL Server Reporting Services in the database for Team Foundation.

    Important noteImportant Note:

    If you have installed SP1 for Microsoft Visual Studio Team System 2008 Team Foundation Server, the /ReportServer parameter will not function correctly. For more information about this problem and its resolution, see this Knowledge Base article on the Microsoft Web site: Team Foundation Server 2008 SP1 TfsAdminUtil.exe 'ConfigureConnections' fails to properly set ReportServerUri. 

  • The /TswaUri option sets configuration information for Team System Web Access, if it is installed.

The ConfigureConnections command does not clear the caches on client computers so that they can use the new configuration information for the components of Team Foundation Server. Before client computers can use the new information, you must first clear their caches manually.

To clear the cache on a client computer for Team Foundation

  1. Log on to the client computer by using the user credentials of the user whose account you want to update, and close any open instances of Visual Studio.

  2. Open a browser, and browse to one of the following folders, depending on the operating system that is running on the client computer:

    • Windows XP or Windows Server 2003

      Drive**:\Documents and Settings\UserName\Local Settings\Application Data\Microsoft\Team Foundation\2.0\Cache**

    • Windows Vista

      Drive**:\Users\UserName\Application Data\Local\Microsoft\Team Foundation\2.0\Cache**

  3. Delete the contents of the Cache directory, including all subfolders.

  4. Repeat these steps for every user account on the computer that accesses Team Foundation Server.

    Note

    You might want to consider distributing instructions on how to clear the cache to all of your Team Foundation Server users so that they can clear the cache for themselves.

Example

The following example displays the current values for ATUri, PublicATUri, SharepointUri, SharepointSitesUri, SharepointAdminUri, SharepointUnc, ReportsUri, ReportServerUri, and TswaUri. If no value is set, the output indicates that no value has been set.

>TFSAdminUtil ConfigureConnections /view

The following example sets the PublicATUri to a new value of http://contoso.example.com:8080.

>TFSAdminUtil ConfigureConnections /PublicATUri:http://contoso.example.com:8080

See Also

Other Resources

Using Team Foundation Server Command-Line Tools

Administering Team Foundation Server

Managing Team Foundation Server Services and Service Accounts