This documentation is archived and is not being maintained.

How to: Stop a Build

The ability to stop a Team Foundation Build that is already in progress is not included in the Team Foundation user interface in Team Foundation Server; however, you can stop a build by using the command TFSBuild stop.

Before you run the TFSBuild stop command, you must have the following information:

  • The name of the team project that contains the solution that is being built.

  • The build number of the Team Foundation Build type you want to stop.

  • The URL of the Team Foundation server.

For more information, see Stop Command (Team Foundation Build).

Required Permissions

To complete this task, you must have Administer a build permission set to Allow. For more information, see Team Foundation Server Permissions.

Stopping a Build

The following procedure describes the steps used for stopping a build that is already in progress.

To stop a currently running build

  1. Click Start, click All Programs, point to Microsoft Visual Studio 2005, point to Visual Studio Tools, and then click Visual Studio 2005 Command Prompt.

  2. At the command prompt type:

    c:\>TFSBuild stop http://servername:8080 TeamProjectName BuildNumber

    The BuildNumber must be enclosed in quotation marks if it contains spaces. The typical format for the BuildNumber is BuildType_yyyymmdd.x, where the yyyy specifies the year, for example 2010. The mm specifies month, for example 05, and dd specifies the day, for example 21. The x specifies the build increment on that day, for example for the first build of a given date x would be 1. You can also customize the build numbering format. For more information, see How to: Customize Build Numbers

  3. When you are prompted, type "y" at the command prompt to begin stopping the build. You can optionally enter the /noprompt option to run the command without prompts.

  4. The Build Status on the Team Build Browser is displayed as Stopped. For more information, see How to: View Build Summary Status.

See Also