共用方式為


CreateWorkspaceTask 工作

更新:2007 年 11 月

CreateWorkspaceTask 工作會使用 TFSBuild.proj 檔案內指定的名稱和對應檔案來建立工作區 (Workspace)。

參數

參數

描述

TeamFoundationServerUrl

指定 Team Foundation Server URL。例如,http://MyServer:8080。

BuildUri

指定組建 URI。

BuildDirectory

指定組建目錄。

SourcesDirectory

指定原始程式檔目錄的方案根目錄。

Name

指定工作區名稱。

根據預設,Team Foundation Build 為了取得原始檔所建立的工作區為 $(COMPUTERNAME)$(TeamProject)$(BuildType)。

請覆寫 TFSBuild.proj 檔內的 WorkspaceName 屬性,以使用自訂的工作區名稱。

注意事項:

由於 WorkspaceName 屬性也可以用來產生 VersionToLabel 屬性,所以如果您是以程式設計方式覆寫 WorkspaceName,請務必一併覆寫 VersionToLabel。

Comment

根據預設,由 Team Foundation Build 建立之工作區所使用的註解為「由 Team Build 建立的工作區」。

請覆寫 TFSBuild.proj 檔內的 CreateWorkspaceTaskComment 屬性,即可指定不同的註解。

Name

字串輸出參數。這個參數會指定 WorkspaceName 屬性的值。

Owner

字串輸出參數。這個參數會指定 WorkspaceOwner 屬性的值。

備註

CreateWorkspaceTask 工作定義於 Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll 中。Microsoft.TeamFoundation.Build.targets 檔包含 CreateWorkspaceTask 工作的執行個體 (Instance),而且 Team Foundation Build 會將它當做 InitializeWorkspace 目標的預設實作 (Implementation) 使用。

Team Foundation Build 電腦上的 <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild 資料夾包含 Microsoft.TeamFoundation.Build.targets 檔。

範例

下列範例會示範 Microsoft.TeamFoundation.Build.targets 檔案內所定義之 CreateWorkspaceTask 工作的預設執行個體。

<CreateWorkspaceTask
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    BuildUri="$(BuildUri)"
    BuildDirectory="$(BuildDirectory)"
    SourcesDirectory="$(SolutionRoot)"
    Name="$(WorkspaceName)"
    Comment="$(CreateWorkspaceTaskComment)">
    <Output TaskParameter="Name" PropertyName="WorkspaceName" />
    <Output TaskParameter="Owner" PropertyName="WorkspaceOwner" />
    </CreateWorkspaceTask>

請參閱

工作

逐步解說:從命令列使用 Team Foundation 版本控制

HOW TO:建立對應工作區

HOW TO:在工作區中隱匿和取消隱匿資料夾

HOW TO:自訂組建事件

概念

瞭解 Team Foundation Build 組態檔

使用版本控制工作區

Team Foundation Build 工作

參考

Workspace 命令

其他資源

自訂 Team Foundation Build

Team Foundation Build 目標、工作和屬性