Workfold 命令
在工作區資料夾和 Team Foundation 版本控制伺服器上的資料夾之間建立、修改或顯示有關對應的資訊。
必要的使用權限
若要使用 workfold 命令，您必須是指定或隱含之工作區的擁有人，或者將全域 [管理工作區] 權限設定為 [允許]。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf workfold localfolder [/login:username,[password]]
tf workfold [/workspace:workspacename] [/login:username,[password]]
tf workfold [/collection:TeamProjectCollectionUrl] [/workspace:workspacename] [/login:username,[password]]
serverfolder
tf workfold [/map serverfolder localfolder] [/collection:TeamProjectCollectionUrl]
[/workspace:workspacename][/login:username,[password]
tf workfold /unmap [/collection:TeamProjectCollectionUrl] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder) [/login:username,[password]]
tf workfold /cloak
serverfolder [/workspace:workspacename] [/collection:TeamProjectCollectionUrl] [/login:username,[password]]
tf workfold /decloak serverfolder
[/workspace:workspacename] [/collection:TeamProjectCollectionUrl][/login:username,[password]]
參數
引數 |
描述 |
|---|---|
workspacename |
為 /workspace 選項指定要對其使用指令的工作區名稱。 |
serverfolder |
指定 Team Foundation 版本控制伺服器資料夾的名稱。 |
localfolder |
指定本機資料夾的名稱。 |
TeamProjectCollectionUrl |
Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection)，該集合包含您要與伺服器資料夾比較的資料夾。 |
username |
提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
選項 |
描述 |
|---|---|
/workspace |
指定要在其中作業的工作區的名稱。 |
/map |
指定本機資料夾和 Team Foundation 版本控制伺服器資料夾之間的關聯。 根據預設，除非已指定 /unmap、/cloak 或 /decloak，否則即使未指定這個選項，workfold 命令也會使用它。 |
/unmap |
指定應從工作區移除的資料夾對應。 |
/cloak |
指定應從對工作區所做之任何版本控制動作排除的資料夾。 |
/decloak |
解除隱匿資料夾，以便能將資料夾擷取到工作區中。 |
/collection |
指定 Team 專案集合。 |
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
備註
可以使用 tf 命令列公用程式的 workfold 命令建立及編輯「工作區對應」(Workspace Mappings)。 工作區對應會建立用戶端資料夾，而當您執行 tf get 作業時，會將 Team Foundation 版本控制伺服器資料夾中的所有檔案和子資料夾擷取到該用戶端資料夾中。 如果用戶端資料夾已隱匿，這個 get 作業將不會運作。
您也可以指定星號 (*) 萬用字元，將 Team Foundation Server 資料夾及其直接子項目對應到您的本機工作區。 這通常稱為單一資料夾對應。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
工作區對應的選項
工作區對應是現用項目和隱匿項目的清單。 您可以使用 /map 選項，將 Team Foundation 版本控制伺服器項目加入至工作區中的對應清單。 還可以使用 /cloak 選項，從工作區明確地排除項目。 您只能隱匿具有對應父代的項目。 隱匿是改善批次 Get 作業速度及節省磁碟空間的有效方式，
但應該謹慎使用。 若要避免發生編譯和整合問題，就只能隱匿那些已知在目前和未來專案範圍以外的項目，例如影像和外部文件檔案等。
您可以使用 /unmap 和 /decloak 選項，從工作區對應選擇性地刪除對應項目和隱匿項目。
工作區對應的套用方式
根據預設，工作區對應會以遞迴方式套用。 將本機資料夾對應到 Team Foundation 版本控制伺服器資料夾時，系統會以隱含方式，在所有目前和未來的子資料夾之間建立對應。 例如，如果將 $/projects 對應到 c:\projects，接著再加入名為 $/projects/project_one 的專案，然後執行工作區的 get 作業，Team Foundation 就會自動在 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 對應到 Team Foundation 版本控制伺服器資料夾 $/projects/project_one，並取代 Team Foundation 版本控制伺服器資料夾 $/projects/project_one 之前的工作區對應。
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold