Einstellungen in der Datei "TfsBuildService.exe.config" in Team Foundation Server-Komponenten

Aktualisiert: November 2007

In diesem Thema werden die konfigurierbaren Einstellungen in der Datei TfsBuildService.exe.config erläutert. Diese Datei befindet sich im Verzeichnis <Laufwerk>:\Programme\Microsoft Visual Studio 9\Common7\IDE\PrivateAssemblies auf dem Team Foundation-Anwendungsebenenserver.

Bevor Sie Änderungen an dieser Datei vornehmen, müssen Sie den Visual Studio Team Foundation Build-Dienst beenden. Nach Eingabe der Änderungen starten Sie den Dienst neu.

Einstellungen in TfsBuildService.exe.config

Einstellung

Beschreibung

port

Mit diesem Wert wird der numerische Wert für den Anschluss festgelegt, der auf Team Foundation Server-Anwendungsebene verwendet wird, um eine Verbindung mit dem Team Foundation Build-Computer herzustellen. Dieser Wert muss mit dem Wert identisch sein, der für den Build-Agent auf Anwendungsebene angegeben wird.

Beispiel: Wert = "9191"

InteractivePort

Mit diesem Wert wird der numerische Wert für den Anschluss festgelegt, der auf der Team Foundation Server-Anwendungsebene verwendet wird, um eine Verbindung mit Agents herzustellen, die von dieser ausführbaren Datei gehostet werden. Verwenden Sie diesen Wert, wenn Sie tfsbuildservice.exe als Befehlszeilenanwendung ausführen. Dieser Wert muss mit dem Wert identisch sein, der für den Build-Agent auf Anwendungsebene angegeben wird.

Beispiel: Wert = "9192" Weitere Informationen über das Aktivieren eines sekundären Anschlusses auf einem Buildcomputer finden Sie unter Gewusst wie: Konfigurieren eines interaktiven Anschlusses für Team Foundation Build.

AuthenticationScheme

Legen Sie diesen Wert fest, um zu steuern, welcher Authentifizierungstyp für eingehende Verbindungen akzeptiert wird. Die folgenden Werte werden unterstützt:

  • Anonymous

  • Basic

  • Digest

  • Negotiate

  • Ntlm

Wenn Sie Negotiate festlegen, muss das Visual Studio Team Foundation Build-Dienstkonto eine der folgenden Bedingungen erfüllen, damit die Kerberos-Authentifizierung durchgeführt werden kann:

  • Bei einer Arbeitsgruppe muss es NT AUTHORITY\Local Service sein.

  • Bei einer Domäne muss es NT AUTHORITY\Network Service sein, oder das Konto muss einen gültigen Dienstprinzipalnamen (SPN, Service Principal Name) haben.

AuthorizedUser

Legen Sie diesen Wert fest, um allen Zugriff auf den Agent-Dienst auf ein einzelnes Konto zu beschränken. Wenn Sie diesen Wert festlegen, müssen Sie auch ein Transportauthentifizierungsschema von Basic, Digest, Negotiate oder Ntlm verwenden.

RequireSecureChannel

Legen Sie diesen Boolean-Wert fest, um zu steuern, ob die Transportebenensicherheit für den verfügbar gemachten Dienst verwendet wird. Normalerweise wird HTTP für die Kommunikation verwendet, dies ist jedoch u. U. nicht für einen Computer wünschenswert, der im Internet verfügbar gemacht wird. Legen Sie diesen Wert auf true fest, um den Dienst stattdessen mit HTTPS verfügbar zu machen. Dieser Wert muss mit dem Wert identisch sein, der für den/die Build-Agent(s) auf dem Team Foundation Server-Anwendungsebenenserver angegeben wird.

RequireClientCertificate

Legen Sie diesen Boolean-Wert fest, um zu steuern, ob zum Verwenden eines sicheren Kanals ein Clientzertifikat erforderlich ist.

AllowedTeamServer

Mit diesem Wert wird die URL für die Team Foundation Server-Anwendungsebene festgelegt, über die eine Verbindung mit dem Team Foundation Build-Computer hergestellt werden kann. Beispiel: http://myserver:8080.

ServerAccessUrl

Legen Sie diesen Wert fest, wenn die zur Kommunikation mit der Team Foundation Server-Anwendungsebene erforderliche URL sich von der in AllowedTeamServer festgelegten URL unterscheidet. I. d. R. werden die Anwendungsebene und der Build-Agent vom Internet getrennt. Wenn beispielsweise AllowedTeamServer http://myserver:8080 ist und der Build-Agent http://boundaryserver.corp.company.com:80 verwendet, um eine Verbindung zur Anwendungsebene herzustellen, müssen Sie ServerAccessUrl auf diesen Wert festlegen.

BuildOnFatPartitions

Während des Buildprozesses werden Zugriffssteuerungselemente im Buildverzeichnis eingerichtet, die das Verzeichnis vor unbefugtem Zugriff schützen. Standardmäßig sind nur NTFS-Partitionen zulässig, da von FAT (File Allocation Table)-Partitionen keine Zugriffssteuerungselemente unterstützt werden. Wenn Sie dies umgehen und für Ihren Build FAT-Partitionen verwenden möchten, legen Sie diesen Wert auf true fest.

DoNotDownloadBuildType

Legen Sie diesen Flag auf true fest, wenn Sie die Buildtypdefinition auf dem lokalen Computer verwenden und nicht die Definition von Team Foundation Server herunterladen möchten. Der verwendete lokale Pfad ist der lokale Arbeitsbereich für den Buildtyp.

MSBuildPath

Legen Sie diesen Wert auf den vollständigen Pfad zum Verzeichnis von MSBuild.exe fest, um einen anderen Speicherort als den Standardspeicherort zu verwenden. Sie müssen dies nur festlegen, wenn eine neue Version von .NET Framework installiert ist.

MaxProcesses

Legen Sie diesen Wert fest, um die maximale Anzahl der von Team Foundation Build verwendeten Prozesse zu konfigurieren.

LogFilePerProject

Legen Sie diesen Wert auf true fest, um bei Fehlern und Warnungen Protokolldateien für einzelne Projekte statt für einzelne Kombinationen aus Plattform und Konfiguration zu erstellen.

SourcesSubdirectory

Legen Sie diesen Wert auf das gewünschte Quellenunterverzeichnis für die Build-Agents fest, die diesen Buildcomputer verwenden. Der Standardwert ist Sources.

BinariesSubDirectory

Legen Sie diesen Wert auf das gewünschte Binärdateien-Unterverzeichnis für die Build-Agents fest, die diesen Buildcomputer verwenden. Der Standardwert ist Binaries.

TestResultsSubdirectory

Legen Sie diesen Wert auf das gewünschte Testergebnis-Unterverzeichnis für die Build-Agents fest, die diesen Buildcomputer verwenden. Der Standardwert ist TestResults.

Siehe auch

Aufgaben

Gewusst wie: Ändern der Konfigurationseinstellungen für Team Foundation Server-Komponenten

Konzepte

Globale Einstellungen in der Datei Web.Config für Team Foundation Server-Komponenten

Einstellungen in der Datei "Web.Config" für Builds in Team Foundation Server-Komponenten

Weitere Ressourcen

Verwalten von Konfigurationseinstellungen für Team Foundation Server