Share via

Workfold 命令 （Team Foundation 版本控制）

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制 （TFVC） workfold 命令會建立、修改或顯示工作區資料夾與 TFVC 之 Azure DevOps 伺服器上資料夾之間的對應相關信息。

必要條件

若要使用 workfold 命令，您必須是指定或隱含工作區的擁有者，或是將全域 管理員 註冊工作區的許可權設定為 [允許]。 如需詳細資訊，請參閱 預設 TFVC 許可權。

語法

tf workfold <local-folder> [/login:<username>,[<password>]]

tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]

tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>

tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>] 
[/workspace:<workspace-name>][/login:<username>,[<password>]

tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] 
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]

tf workfold /cloak 
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]

tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]

參數

下列各節說明 命令的 workfold 自變數和選項。

引數

Argument

說明

<workspace-name>

指定命令使用 選項運作 /workspace 的工作區名稱。

<server-folder>

指定 Azure DevOps 伺服器資料夾的名稱。

<local-folder>

指定本機資料夾的名稱。

<team-project-collection-url>

專案集合的 URL，其中包含您要與伺服器資料夾比較的資料夾，例如 https://myserver:8080/tfs/DefaultCollection/。

<username>

提供 選項的值 /login 。 您可以指定此值指定為 DOMAIN\<username> 或 <username>。

<password>

提供 選項的值 /login 。

選項。

選項

說明

/workspace

指定要使用之工作區的名稱。

/map

指定本機資料夾與 Azure DevOps 伺服器資料夾之間的關聯。 根據預設， workfold 命令會使用這個選項，即使未指定，除非 /unmap指定、 /cloak或 /decloak 。

/unmap

指定要從工作區移除的資料夾對應。

/cloak

指定資料夾應該從工作區中所做的任何版本控制動作中排除。

/decloak

將資料夾譯碼，以便將資料夾擷取到工作區中。

/collection

指定專案集合。

/login

指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。

備註

您可以使用 workfold 命令列公用程式的 命令 tf 來建立和編輯 工作區對應。 工作區對應會建立用戶端資料夾，當您執行 tfget 作業時，會擷取 Azure DevOps 伺服器資料夾中的所有檔案和子資料夾。 如果客戶端資料夾已遮蓋，則 get 作業無法運作。

您也可以使用星號 ≦ 通配符，將 Azure DevOps Server 資料夾及其立即項目對應至本機工作區。 此對應通常稱為單一 文件夾對應。

如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用Team Foundation版本控制命令。

工作區對應的選項

工作區對應是使用中和遮蔽項目的清單。 您可以使用 選項，將 Azure DevOps 伺服器專案新增至工作區 /map 中的對應清單。 您也可以使用 /cloak 選項，明確地從工作區中排除專案。 您只能遮蓋具有對應父代的專案。 遮蓋是改善批次 get 作業速度並節省磁碟空間的有效方式。

請隨意使用遮蓋。 為了避免編譯和整合問題，您應該只遮蓋您知道不在目前和未來專案範圍內的這些專案，例如影像和外部文件檔。

您可以使用 /unmap 和 /decloak 選項，選擇性地從工作區對應中刪除對應和遮蔽的專案。

如何套用工作區對應

根據預設，工作區對應會以遞歸方式套用。 當您將本機資料夾對應至 Azure DevOps 伺服器資料夾時，系統會隱含地建立其目前和未來子資料夾之間的對應。

例如，假設您將 $/projects 對應至 C：\projects。 接下來，您會新增名為 $/projects/project_one 的項目，然後在工作區上執行 get 命令。 在此案例中，TFVC 會自動在 C：\projects 目錄中建立名為 project_one 的本機工作資料夾。

下列範例會使用星號 \ 通配符，將伺服器資料夾及其立即項目對應至本機工作區：

tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject

下列範例會workfold使用 命令覆寫在 $/projects/project_one 與 C：\projects\project_one 之間自動建立的對應：

tf workfold $/projects/project_one C:\DifferentWorkfold

外衣下的對應

位於版本控制階層中隱藏資料夾底下的未隱藏資料夾對應，可以對應至您的本機工作區。

範例

下列範例會顯示 c：\projects 所在工作區的對應：

c:\projects>tf workfold

下列範例會遮蓋 c：\projects\lib 資料夾：

c:\projects>tf workfold /cloak c:\projects\lib

下列範例會顯示本機檔案 word.cs的對應：

c:\projects>tf workfold word.cs

下列範例會將 C：\DifferentWorkfold 資料夾對應至 Azure DevOps 伺服器資料夾 $/projects/project_one，並取代 $/projects/project_one Azure DevOps 伺服器資料夾先前的工作區對應：

c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold