TfsBuildService.exe.config File Settings in Team Foundation Server Components

  • Article

This topic describes the configurable settings in the TfsBuildService.exe.config file. This file is located in <drive>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies on the Team Foundation application-tier server.

Before you make changes to this file, you must stop the Visual Studio Team Foundation Build service. After you make a change, restart the service.

TfsBuildService.exe.config Settings

Setting

Description

port

Set this value to specify the numeric value that represents the port that is used by the Team Foundation Server application tier to connect to the Team Foundation Build computer. This value must be the same as the value specified for the build agent on the application tier.

For example: value = "9191"

InteractivePort

Set this value to specify the numeric value that represents the port used by the Team Foundation Server application tier to connect to agents hosted by this executable. Use this value when you run tfsbuildservice.exe as a command-line application. This value must be the same as the value specified for the build agent on the application tier.

For example: value = "9192". For more information about how to enable a second port on a build computer, see How to: Configure an Interactive Port for Team Foundation Build.

AuthenticationScheme

Set this value to control what type of authentication will be accepted for incoming connections. The following values are supported:

  • Anonymous

  • Basic

  • Digest

  • Negotiate

  • Ntlm

If you specify Negotiate, the Visual Studio Team Foundation Build service account must satisfy one of the following conditions in order for Kerberos authentication to work:

  • If on a workgroup, it must be NT AUTHORITY\Local Service.

  • If on a domain, it must be NT AUTHORITY\Network Service or the account must have a valid service principal name, SPN.

AuthorizedUser

Set this value to restrict all access to the agent service to a single account. If you set this value, you must also use a transport authentication scheme of Basic, Digest, Negotiate, or Ntlm.

RequireSecureChannel

Set this Boolean value to control whether or not transport-layer security is used for the exposed service. Normally, HTTP is used for communications, but this may not be desirable for a computer exposed on the internet. Set this value to true to expose the service using HTTPS instead. This value has to be the same as the value specified for the build agent(s) on the Team Foundation Server application tier server.

RequireClientCertificate

Set this Boolean to control whether or not a client certificate is required when using a secure channel.

AllowedTeamServer

Set this value to specify the URL for the Team Foundation Server application tier that can connect to the Team Foundation Build computer. For example, http://myserver:8080.

ServerAccessUrl

Set this value when the URL required to communicate with the Team Foundation Server application tier is different from the one specified in AllowedTeamServer. Typically, the application tier and the build agent are separated by the internet. For example, if AllowedTeamServer is http://myserver:8080, and the build agent uses http://boundaryserver.corp.company.com:80 to connect to the application tier, you need to set ServerAccessUrl to this value.

BuildOnFatPartitions

As part of the build process, access controls are set in the build directory to help secure it against unauthorized access. By default, only NTFS partitions are allowed because file allocation table (FAT) partitions do not support access controls. To override this to build on FAT partitions, set this value to true.

DoNotDownloadBuildType

Set this flag to true if you want to use the build type definition that exists on the local computer instead of downloading the definition from Team Foundation Server. The local path used is the local workspace for the build type.

MSBuildPath

Set this value to the full path to the directory of MSBuild.exe to use a location other than the default location. You need to set this only if a new version of the .NET Framework is installed.

MaxProcesses

Set this value to configure the maximum number of processes used by Team Foundation Build.

LogFilePerProject

Set this value to true to generate errors and warnings log files for individual projects instead of for individual Platform and Configuration combinations.

SourcesSubdirectory

Set this value to the desired sources subdirectory for the build agents that use this build computer. The default value is Sources.

BinariesSubDirectory

Set this value to the desired binaries subdirectory for the build agents that use this build computer. The default value is Binaries.

TestResultsSubdirectory

Set this value to the desired test results subdirectory for the build agents that use this build computer. The default value is TestResults.

See Also

Tasks

How to: Change Configuration Settings for Team Foundation Server Components

Concepts

Global Web.Config File Settings in Team Foundation Server Components

Build Web.Config File Settings in Team Foundation Server Components

Other Resources

Managing Configuration Settings for Team Foundation Server