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 (TFS). By default, the notification interface URL and the server URL match in TFS, but you can configure separate URLs. For example, you might want to use a different URL for the automatic e-mails that TFS 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.
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 TFS. 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 examples are for illustration only and are fictitious. No real association is intended or inferred.
TFSConfig Settings /NotificationURL:http://contoso.example.com/tfs /ServerURL:http://contoso.example.com:8080/tfs