Get 工作
更新：2007 年 11 月
Get 工作會使用指定的選項，擷取工作區 (Workspace) 中檔案和資料夾的唯讀複本。
參數
參數 |
描述 |
|---|---|
BuildUri |
指定組建 URI。 |
Workspace |
指定工作區名稱。 |
Version |
指定 versionspec 檔案。根據預設，versionspec 使用的是 T 或最新版本。設定 TFSBuild.proj 檔內 GetVersion 屬性，即可取得不同的版本。此行為對應至 tf.exe get 命令的 /version 選項。如需詳細資訊，請參閱 Get 命令。 |
Filespec |
指定工作區內的項目。根據預設，Team Foundation Build 會取得工作區內 WorkspaceName 屬性指定的所有項目。覆寫 TFSBuild.proj 檔內的 GetFileSpec 屬性，即可指定特定的 Itemspec。這對應至 tf.exe get 命令的 Itemspec 參數。 |
PopulateOutput |
根據預設，Team Foundation Build 不會傳回已擷取、已取代或已刪除的項目清單，也不會傳回由 Get 工作產生的警告。將 TFSBuld.proj 檔內的 GetPopulateOutput 屬性設定為 true，即可使用這些清單。將 GetPopulateOutput 設定為 true 時，即可取得下列項目：
|
Preview |
指定是否要在不實際執行 Get 作業的情形下，顯示將發生的項目。將 TFSBuild.proj 檔內的 PreviewGet 設定為 true，即可預覽Get 作業。這對應於tf.exe get 中 /preview 選項。 |
Recursive |
指定是否要遞迴地擷取檔案。將 TfsBuild.proj 檔內的 RecursiveGet 屬性設定為 false，即可在 Team Foundation Build 專案中進行非遞迴性取得作業。這對應於tf.exe get 中 /recursive 選項。 |
Force |
指定是否要以累加方式擷取檔案。若要在 Team Foundation Build 定義中進行累加取得作業，請將 TfsBuild.proj 檔內的 ForceGet 屬性設定為 false。這對應至 tf.exe get 命令的 /force 選項。 |
Gets |
輸出參數。指定已由 Get 工作擷取的項目清單。 |
Replaces |
輸出參數。指定已由 Get 工作取代的項目清單。 |
Deletes |
輸出參數。指定已由 Get 工作刪除的項目清單。 |
Warnings |
輸出參數。指定已由 Get 工作產生的警告清單。 |
備註
Get 工作定義於 Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll 中。Microsoft.TeamFoundation.Build.targets 檔包含 Get 工作的執行個體 (Instance)，而且 Team Foundation Build 會將它當做 CoreGet 目標的預設實作 (Implementation) 使用。
Team Foundation Build 電腦上的 <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild 資料夾包含 Microsoft.TeamFoundation.Build.targets 檔。
範例
下列範例會顯示在 Microsoft.TeamFoundation.Build.targets 檔中定義之 Get 工作的預設執行個體。
<Get
BuildUri="$(BuildURI)"
Workspace="$(WorkspaceName)"
Version="$(GetVersion)"
Filespec="$(GetFilespec)"
PopulateOutput="$(GetPopulateOutput)"
Preview="$(PreviewGet)"
Recursive="$(RecursiveGet)"
Force="$(ForceGet)">
<Output TaskParameter="Gets" ItemName="Gets" />
<Output TaskParameter="Replaces" ItemName="Replaces" />
<Output TaskParameter="Deletes" ItemName="Deletes" />
<Output TaskParameter="Warnings" ItemName="GetWarnings" />
</Get>