Share via


Configure Command

Enables an administrator to view and change the following configuration settings for a team project in the Source Control Settings dialog box:

  • Check-out settings

  • Check-in policies

  • Check-in notes

Required Permissions

To use the configure command, you must have the Edit server-level information permission set to Allow. For more information, see Team Foundation Server Permissions.

tf configure [path of team project] [/server:servername]

Parameters

Argument

Description

path of team project

Path of the team project.

servername

The user-provided value for the /server option. Example: teamserver2.

Option

Description

/server

Identifies the Team Foundation Server. This option is required if the command is invoked from a directory that is not mapped to a workspace.

Remarks

You can manage the following team project settings using the configure command:

  • Check-out settings can be used to determine whether multiple users can edit files at the same time. Also, they can be used to configure the get latest on check-out behavior.

  • Check-in policies provide controls that are invoked at check-in time, to make sure that defined criteria are met before a user checks in pending changes.

  • Check-in notes define custom fields into which users provide information during the check-in process. Check-in notes can be either required or optional.

The settings are configured in the Source Control Settings dialog box which appears after you run the configure command. When you complete your changes, click OK to save them to the server.

For more information about these settings, see Walkthrough: Customizing Check-In Policies and Notes.

For links to other Team Foundation commands that provide additional information about the items in your Team Foundation version control server and all the workspaces that map to it, see Informational Commands.

For more information on how to find the tf command-line utility, see Tf Command-Line Utility Commands.

Examples

The following example displays the SourceControlSettings dialog box in which you can examine and modify the team project settings of the workspace for the c:\projects folder.

c:\projects>tf configure

The following example displays the myproj team project settings on teamserver2.

c:\projects>tf configure $/myproj /server:teamserver2

See Also

Tasks

Walkthrough: Working with Team Foundation Version Control from the Command Line

Walkthrough: Creating a New Team Project

How to: Configure Check-Out Settings

Concepts

File Types

Other Resources

Tf Command-Line Utility Commands

Configuring Version Control Settings