Settings Command
You can use the Settings command to automate changes to the uniform resource locator (URL) that is used by the notification interface and for the server address for Visual Studio Team Foundation Server. By default, the notification interface URL and the server URL match in Team Foundation Server, but you can configure separate URLs. For example, you might want to use a different URL for the automatic e-mails that Team Foundation Server generates. You must run this tool from the application tier to update all servers so that they use the new URLs.
To change these URLs interactively or to just view the current settings, you can use the administration console for Team Foundation. For more information, see Open the Team Foundation Administration Console.
Required Permissions
To use the Settings command, you must be a member of the Team Foundation Administrators security group and the Administrators group on the application-tier server for Team Foundation. For more information, see Team Foundation Server Permissions.
Note
Even if you log on with administrative credentials, you must open an elevated Command Prompt window to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt window, 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.
TFSConfig Settings [/ServerURL:URL] [/NotificationURL:URL]
Parameters
Placeholder |
Description |
|---|---|
URL |
Use to set the uniform resource locator (URL) with the appropriate option. |
Option |
Description |
|---|---|
/ServerURL:URL |
Specifies the URL of the application-tier server for Team Foundation. This value is stored in the configuration database for Team Foundation. |
/NotificationURL:URL |
Specifies the URL to use in the text of e-mail alerts, if that URL differs from the URL of the application-tier server for Team Foundation. This value is stored in the configuration database. |
Remarks
The Settings command changes connection information for server-to-server communication in a deployment of Team Foundation Server. The URL that is specified in /ServerURL must be available to all servers within the deployment.
Example
The following example changes the value of NotificationURL to http://contoso.example.com/tfs and the value of ServerURL to http://contoso.example.com:8080/tfs.
Note
The example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, places, or events is intended or should be inferred.
TFSConfig Settings /NotificationURL:http://contoso.example.com/tfs /ServerURL:http://contoso.example.com:8080/tfs