共用方式為


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_oneC:\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