How to: Establish Permissions for Team Foundation Build Agent

Team Foundation Build uses build definitions to configure the conditions under which you can build a single solution or a set of solutions in a team project. In order to run a build, you will have to either create a new build definition or use an existing build definition that has been created previously. For more information about how to create a new build definition, see How to: Create a Build Definition.

You must make sure that the appropriate security permissions have been established on the build agent that the build definition is configured to use. Also, be sure the users who run the build have the appropriate permissions.

Required Permissions

To perform this procedure, you must have the Team Foundation Start a build permission set to Allow. For more information, see Team Foundation Server Permissions.

To establish build permissions

  1. Contact the system administrator for the build agent that you selected and determine the name of the account under which Visual Studio Team Foundation Build service is running.

  2. On Team menu, select Team Project Settings, and then Group Membership.

    The Project Groups dialog box appears.

  3. Under the Groups, select <Team project name>\Build Service, and then click Properties.

    The Team Foundation Server Group Properties dialog box appears.

  4. Click the Members tab.

    If the account name from step 1 is present in the member list, then the selected build agent can build this build definition. Otherwise, follow these steps:

    1. In the Add users and groups section, select Windows User or Group, and then click Add.

      The Select Users or Groups dialog box appears.

    2. In Select Users or Groups dialog box, type the name of the account that is associated with the Visual Studio Team Foundation Build service on the build agent used for this build definition.


    If this build definition is built on multiple build agents, then all the Team Foundation Build Service accounts must be added as members of this project Build Services group.

  5. To configure which users you want to run build definitions, on the Team menu click Team Project Settings, click Security, and then click Start a build to grant permissions to these users.

See Also


Walkthrough: Running a Build Definition in Team Foundation Build

How to: Set up and Install Team Foundation Build

How to: Create a Build Definition


Start Command (Team Foundation Build)