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