HOW TO：建立和管理組建代理程式

發行項
08/21/2008

更新：2007 年 11 月

建立新的組建定義之前，您必須先設定一部要將其指定為組建代理程式的電腦。如需詳細資訊，請參閱 HOW TO：設定及安裝 Team Foundation Build。在將 Team Foundation Build 和必要的元件安裝在一或多部電腦上之後，您就可以使用 Visual Studio Team System 使用者介面來建立新的組建代理程式，或者管理現有的組建代理程式。每個組建代理程式只能與一個通訊埠產生關聯。這通常表示每個組建代理程式都會與一部組建電腦產生關聯。不過，您也可以從命令列執行 tfsbuildservice.exe，指定可以使用的互動通訊埠。互動通訊埠可讓您執行包含開頭和結尾 Windows Form 在內的測試。如需詳細資訊，請參閱 Team Foundation Server 元件中的 TfsBuildService.exe.config 檔案設定和 HOW TO：設定 Team Foundation Build 的互動通訊埠。

必要權限

您必須將 [管理組建] 使用權限設定為 [允許]，才能執行此程序。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

建立新的組建代理程式

使用 [管理建置代理程式] 對話方塊，將某部電腦指定為組建代理程式。

若要建立新的組建代理程式

選取您要在 Team 總管內與組建代理程式產生關聯的 Team 專案。
按一下 [建置] 功能表上的 [管理建置代理程式]。

[管理建置代理程式] 對話方塊隨即出現。
按一下 [新增]。

[建置代碼程式屬性] 對話方塊隨即出現。
在 [顯示名稱] 文字方塊內輸入組建代理程式的名稱。

[管理組建代理程式] 對話方塊會顯示這個名稱。
在 [描述] 文字方塊內輸入選擇性的描述。

例如，「此建置代理程式專門用於執行積存組建」。
在 [電腦名稱] 文字方塊內輸入已安裝 Team Foundation Build 之電腦的電腦名稱。
在 [通訊連接埠] 文字方塊中，輸入 Team Foundation 用於與 Team Foundation Build 進行通訊的通訊埠編號。

預設值為 9191。如需 Team Foundation 使用之通訊埠的詳細資訊，請參閱 Team Foundation Server 安全性架構。
如果想要設定組建代理程式，讓它需要 HTTPS 和 Secure Sockets Layer (SSL)，請核取 [必須有安全通道 (HTTPS)]。

如需使用 HTTPS 所需步驟的詳細資訊，請參閱 HOW TO：設定組建代理程式以要求 HTTPS 和 Secure Sockets Layer (SSL)。
在 [工作目錄] 文字方塊內，為組建代理程式上的工作目錄輸入值。

預設值為 $(Temp)\$(BuildDefinitionPath)。BuildDefinitionPath 屬性會展開為 <Team Project>\<Build Definition Name>。您也可以使用 BuildDefinitionId，它會展開成對組建定義而言具有唯一性的整數識別項。BuildDefinitionId 通常用於建立較短的路徑。

注意事項：

按一下 [預設] 按鈕，即可將 [通訊] 和 [工作目錄] 文字方塊值還原為其預設值。

[啟用] 是 [代理程式狀態] 的預設值。其他值會視情況顯示，以反映代理程式狀態。

注意事項：
按一下 [預設] 按鈕，即可將 [通訊] 和 [工作目錄] 文字方塊值還原為其預設值。

編輯和移除組建代理程式

您也可以使用 [管理建置代理程式] 對話方塊，編輯及移除已指定的組建代理程式。

若要移除組建代理程式

選取內含您想要在 Team 總管內移除之組建代理程式的 Team 專案。
按一下 [建置] 功能表上的 [管理建置代理程式]。

[管理建置代理程式] 對話方塊隨即出現。
在 [組建代理程式] 清單內選取要移除的組建代理程式，然後按一下 [移除]。

組建代理程式便隨即從清單中移除。

若要編輯組建代理程式

選取內含您想要在 Team 總管內編輯之組建代理程式的 Team 專案。
按一下 [建置] 功能表上的 [管理建置代理程式]。

[管理建置代理程式] 對話方塊隨即出現。
在 [組建代理程式] 清單內選取要編輯的組建代理程式，然後按一下 [編輯]。

[建置代碼程式屬性] 對話方塊隨即出現。
在 [建置代理程式屬性] 對話方塊上，您可以編輯任何項目，然後按一下 [確定] 儲存這些項目。
若要停用組建代理程式，請從 [代理程式狀態] 下拉式功能表 (Drop-Down Menu) 中選取 [停用]。

當組建代理程式的狀態設定為 [停用] 時，已佇列的所有組建在佇列中都將保持為作用狀態 (Active State)，直到組建代理程式再次設定為 [已啟用] 為止。

請參閱

共用方式為