如何：创建和管理生成代理
更新：2007 年 11 月
在新建生成定义之前，必须首先设置一台要指定为生成代理的计算机。有关更多信息，请参见如何：安装 Team Foundation Build。在一台或多台计算机上安装了 Team Foundation Build 以及所需的组件之后，您可以使用 Visual Studio Team System 用户界面来创建新的生成代理或管理现有的生成代理。每个生成代理只能与一个端口相关联。大多数情况下，这意味着每个生成代理与一台生成计算机相关联。但也可以指定一个交互式端口，可以通过在命令行上运行 tfsbuildservice.exe 来使用该端口。通过此交互式端口可以运行包括打开和关闭 Windows 窗体的测试。有关更多信息，请参见 Team Foundation Server 组件中的 TfsBuildService.exe.config 文件设置和如何：为 Team Foundation Build 配置交互式端口。
必需的权限
若要执行此过程，您的“管理生成”权限必须设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。
创建新的生成代理
使用“管理生成代理”对话框将一台计算机指定为生成代理。
创建新的生成代理
选择要与团队资源管理器中的生成代理相关联的团队项目。
在“生成”菜单上单击“管理生成代理”。
随即出现“管理生成代理”对话框。
单击“新建”。
随即出现“生成代理属性”对话框。
在“显示名称”文本框中键入生成代理的名称。
“管理生成代理”对话框即会显示此名称。
在“说明”文本框中键入可选的说明。
例如，“此生成代理专用于滚动生成”。
在“计算机名”文本框中，输入安装了 Team Foundation Build 的计算机的名称。
在“通信端口”文本框中，输入 Team Foundation 用来与 Team Foundation Build 进行通信的端口号。
默认值为 9191。有关 Team Foundation 所使用的端口的更多信息，请参见 Team Foundation Server 安全结构。
如果要将生成代理设置为要求使用 HTTPS 和安全套接字层 (SSL)，请选中“要求安全通道(HTTPS)”。
有关使用 HTTPS 所需的步骤的更多信息，请参见如何：将生成代理设置为要求 HTTPS 和安全套接字层 (SSL)。
在“工作目录”文本框中为生成代理上的工作目录输入一个值。
默认值为 $(Temp)\$(BuildDefinitionPath)。BuildDefinitionPath 属性将扩展为 <团队项目>\<生成定义名称>。您也可以使用 BuildDefinitionId，它将扩展为一个专用于生成定义的整数标识符。通常，BuildDefinitionId 用于创建较短的路径。
.gif "说明")
说明：单击“默认”按钮，将“通信”和“工作目录”文本框值还原为其默认值。
“启用”是“代理状态”的默认设置。适当情况下会显示其他反映代理状态的值。
编辑和移除生成代理
您也可以使用“管理生成代理”对话框来编辑和移除已指定的生成代理。
移除生成代理
选择包含团队资源管理器中要移除的生成代理的团队项目。
在“生成”菜单上单击“管理生成代理”。
随即出现“管理生成代理”对话框。
在“生成代理”列表中选择要移除的生成代理，再单击“移除”。
该生成代理将从该列表中移除。
编辑生成代理
选择包含团队资源管理器中要编辑的生成代理的团队项目。
在“生成”菜单上单击“管理生成代理”。
随即出现“管理生成代理”对话框。
在“生成代理”列表中选择要编辑的生成代理，再单击“编辑”。
随即出现“生成代理属性”对话框。
在“生成代理属性”对话框上，可以编辑任何项，然后单击“确定”进行保存。
若要禁用生成代理，请从“代理状态”下拉菜单中选择“禁用”。
将生成代理状态设置为“禁用”之后，已进入队列的任何生成都将以活动状态保留在队列中，直到将生成代理状态再次设置为“启用”为止。
请参见
任务
演练：在 Team Foundation Build 中创建生成定义
如何：为 Team Foundation Build 代理设置权限
演练：通过自定义任务自定义 Team Foundation Build