reserve (Team Foundation Build)

The reserve command reserves a port for a specified user or account.

Required Permissions

To run the reserve command, you must be a Windows administrator on the build computer. For more information, see Team Foundation Server Permissions.

Note

Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as Administrator. For more information, see the Microsoft Web site.

Wcfhttpconfig reserve user port

Parameters

Argument

Description

user

The user who is going to be using the port.

port

The number or URLPrefix of the port that is reserved. For more information about URLPrefixes, see https://go.microsoft.com/fwlink/?LinkId=94851.

Remarks

Sometimes it is necessary to use a URLPrefix instead of a port number when HTTPS is required for a build agent.

Example

The following example reserves the port 9191 for DOMAIN\TeamBuildAccount.

>wcfhttpconfig.exe reserve DOMAIN\TeamBuildAccount 9191

The following example reserves the port 9191 by using a URLPrefix.

>wcfhttpconfig.exe reserve https://+:9191/Build/v2.0/AgentService.asmx

See Also

Tasks

How to: Modify Settings in TfsBuildService.exe.config file

How to: Configure an Interactive Port for Team Foundation Build

How to: Set up a Build Agent to Require HTTPS and Secure Sockets Layer (SSL)

Other Resources

Team Foundation Build Commands