Managing Server Configuration with TFSConfig

By using the TFSConfig command-line tool, you can configure or create a script to configure many aspects of your deployment of Visual Studio Team Foundation Server. For example, you can use the commands in TFSConfig to find information about or change the following items in esprtfs:

  • service accounts and their passwords

  • addresses and ports that Team Foundation Server uses

  • the state of team project collections that are part of the deployment

  • the software updates that are applied to the application tier for Team Foundation and the databases for Team Foundation Server

  • information about other components, such as Team Foundation Build or Visual Studio Lab Management 

    Note

    You can also configure a server interactively by using the administration console for Team Foundation. For more information, see The Team Foundation Administration Console.

You can use TFSConfig to configure Team Foundation Server to use credentials, addresses, and ports that you have already defined. You cannot use the tool to create accounts or change the addresses that components such as SharePoint Products use. For example, you can use TFSConfig to change service accounts and passwords as long as the accounts and passwords already exist. You can also use TFSConfig to help repair or recover your deployment if an unexpected event occurs. For example, you can use it to repair your deployment if a software update does not apply to all components in the system or if a restoration of databases from a backup leaves a collection database improperly detached.

You must run TFSConfig from the application tier for Team Foundation. By default, TFSConfig is located in Drive:\Program Files\Microsoft Team Foundation Server 2010\Tools.

Note

Even if you log on with administrative credentials, you must open an elevated Command Prompt window to run TFSConfig on a server that is running Windows Server 2008, Windows Server 2008 R2, Windows Vista or Windows 7. To open an elevated Command Prompt window, click Start, right-click Command Prompt, and click Run as Administrator. For more information, see this page on the Microsoft Web site: User Account Control.

To operate correctly, TFSConfig must be able to connect to the following servers and services:

  • The instance or instances of SQL Server that host any databases that this deployment of Team Foundation Server uses, such as the configuration database and databases for team project collections.

  • Any SharePoint Web applications that this deployment of Team Foundation Server uses.

  • Any instance of SQL Server Reporting Services that this deployment of Team Foundation Server uses.

  • The Active Directory domain controller, if Team Foundation Server is deployed in a domain.

  • Internet Information Services (IIS) on the application-tier server or servers.

  • Any server that is running Team Foundation Build and is used by this deployment.

  • Any server that is running Visual Studio Lab Management and is used by this deployment.

You can use the global options that are listed in the following table with most TFSConfig commands. The exceptions are noted in the specific topics for those commands.

Option

Description

/?

Displays the command syntax and options for TFSConfig.

/NoPrompt or /i

Specifies that the administrator is not prompted before changes are committed.

In This Section

Accounts Command

Authentication Command

Certificates Command

ChangeServerID Command

Collection Command

ConfigureMail Command

Diagnose Command

Identities Command

Import Command (TFSConfig)

Jobs Command

Lab Commands

License Command

PrepSQL Command

RebuildWarehouse Command

Recover Command

RegisterDB Command

RemapDBs Command

Repair Command

Settings Command

Updates Command