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. See Configure and manage TFS resources.

Requirements

  • You must be a member of the Team Foundation Administrators security group and the Administrators group on the application-tier server. For more information, see Set administrator permissions for Team Foundation Server.

  • Even if you log on with administrative credentials, you must open an elevated Command Prompt window.

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

See Also

Other Resources

Command-line tools for TFS