Services Web.Config File Settings in Team Foundation Server Components

This topic describes the configurable settings in the Services Web.Config file. Although changing the values in this file will change some of the configuration settings for Team Foundation Server, it will not necessarily change the information in all locations required for a successful configuration change. Configuration information for Team Foundation Server is stored in five locations, not all of which are in Web.Config files. For more information about how and where Team Foundation Server stores configuration information, see Team Foundation Server Security Architecture. For a general procedure that describes how to access and change these settings, see How to: Change Configuration Settings for Team Foundation Server Components.

Services Web.Config Settings

Setting

Description

ConnectionString

This setting is a string that represents the connection string that the application tier uses to connect to the data tier.

eventingEnabled

This setting is a Boolean value that enables or disables the Team Foundation Server event system (alerts).

emailNotificationFromAddress

This setting is a string that represents the "from address" in e-mail notifications from Team Foundation Server for check-ins, work items assigned to you, and so on. This address is also checked for validity and, depending on your server configuration, might have to represent a valid e-mail account on the mail server.

If the address does not exist or is not valid, TeamSystem@microsoft.com is used.

smtpServer

This setting is a string that represents the name of the mail server.

DetailedException

This setting is a Boolean value that enables or disables whether the text from exceptions is reported in the error message. The default value is false.

IdentityUpdateInitial

This setting is a string in the format Hours:Minutes:Seconds. This setting and IdentityUpdatePeriod control the frequency with which the list of users are synchronized with Active Directory. An initial synchronization starts on a background thread when the Services Web application starts. At that time, a timer is created that will trigger first after the time period specified by IdentityUpdateInitial and subsequently at an interval specified by IdentityUpdatePeriod. By default, this setting is "1:0:0" (one hour). If the list of users does not often change, you could increase the value of this setting to reduce the load put on Active Directory.

NoteNote:
By default, this setting and its value are not in the Services Web.Config file. If you want to specify a value, you must add the setting.

IdentityUpdatePeriod

This setting is a string in the format Hours:Minutes:Seconds. This setting and IdentityUpdateInitial control the frequency with which the list of users is synchronized with Active Directory. An initial synchronization starts on a background thread when the Services Web application starts. At that time, a timer is created that will trigger first after the time period specified by IdentityUpdateInitial and subsequently at an interval specified by IdentityUpdatePeriod. By default, this setting is "1:0:0" (one hour). If the list of users is does not often change, you could increase the value of this setting to reduce the load put on Active Directory.

NoteNote:
By default, this setting and its value are not in the Services Web.Config file. If you want to specify a value, you must add the setting.

See Also

Tasks

How to: Change Configuration Settings for Team Foundation Server Components

How to: Configure SMTP Server and E-mail Notification Settings in the Services Web.Config File

Concepts

Global Web.Config File Settings in Team Foundation Server Components

Other Resources

Managing Configuration Settings for Team Foundation Server