工作區指令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） workspace 命令可讓您建立、刪除、檢視或修改與工作區相關聯的屬性和對應。
先決條件
- 若要修改或刪除現有的工作區，請成為擁有者，或擁有全域 管理工作區 許可權設定為 Allow。
- 若要建立工作區，請將全域 建立工作區 許可權設定為 [允許]。
- 若要為其他使用者建立工作區，請將 [管理工作區] 許可權設定為 [允許]。
如需詳細資訊，請參閱 預設 TFVC 權限。
語法
tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]
參數
下列各節說明 workspace 命令的自變數和選項。
參數
| 論點 | 描述 |
|---|---|
<workspace-name> |
指定您要建立、編輯、刪除或顯示相關資訊的工作區名稱。 |
<workspace-owner> |
指定工作區的用戶名稱。 當工作區擁有者不是執行命令的人員時，需要此參數。 |
<computer-name> |
提供值給 [/computer] 選項。 |
<comment> |
提供值給 [/comment] 選項。 |
@<comment-file> |
指定應該讀取批注的檔案路徑。 |
<username> |
提供值給 [/login] 選項。 您可以將此值指定為 DOMAIN\<username> 或 <username>。 |
<password> |
提供值給 [/login] 選項。 |
<team-project-collection-url> |
專案集合的 URL，其中包含您要建立、編輯、刪除或顯示相關信息的工作區，例如，https://myserver:8080/tfs/DefaultCollection。 |
<owner-name> |
提供值給 [/newowner] 選項。 |
選項
| 選擇 | 描述 |
|---|---|
/new |
建立新的工作區。 |
/template |
指定要作為建立新工作區之範本的現有工作區。 新的工作區會使用現有工作區的對應。 |
/delete |
刪除指定的工作區。 |
/computer |
指定要在其中建立工作區的計算機名稱。 此選項是進階選項。 |
/comment |
提供描述工作區的批注。 |
/newname |
重新命名現有的工作區。 |
/noprompt |
執行指定的工作區命令，而不顯示對話方塊。 |
/collection |
指定專案集合。 |
/permission |
指定工作區權限的選項：
Private：只有擁有者可以使用、存回檔案，或管理工作區。
- Public Limited：任何有效的使用者都可以使用工作區。 但只有擁有者可以簽入檔案，或管理工作區。
- Public：任何有效的使用者都可以使用、簽入檔案，或管理工作區。 |
/location |
指定建立工作區的位置：
local：在用戶端計算機上。 此值為預設值。
- server：在 Azure DevOps 伺服器上。 |
/login |
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。 |
/newowner |
指定工作區新擁有者的用戶名稱。 |
言論
工作區 是伺服器上的檔案和資料夾本地副本，以及您在本機所做的任何變更。 當您新增、編輯、刪除、移動、重新命名或變更任何版本控制的專案時，您的變更會隔離在工作區中，您可以在其中進行及測試變更。 當您 將工作簽入小組的程式代碼基底時，您會將變更認可至伺服器。 他們可供位於工作區外部的其他使用者使用。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
建立工作區
您必須先建立工作區，或建立現有工作區與目前目錄的關聯，才能將檔案新增至版本控制伺服器或簽出伺服器上的專案。 如需詳細資訊，請參閱 在開發電腦上設定 Team Foundation 版本控制。
若要讓目前目錄成為電腦上現有工作區的工作資料夾，請遵循下列步驟：
- 輸入
tf workspace <workspace-name>，其中<workspace-name>是現有工作區的名稱。 [編輯工作區] 對話框隨即出現。 - 選取 [按這裏以輸入新的工作資料夾。
- 在 [原始檔控制資料夾] 方塊中，輸入您要對應目前目錄的伺服器路徑。
- 在 [本機資料夾] 方塊中，輸入目前的目錄。
- 選取 [確定] 。
當您建立新的工作區時，可以指定 範本工作區 做為 [/new] 選項的一部分。 當您指定範本工作區時，TFVC 會在目前的電腦上建立新的工作區。 TFVC 也會將擁有者設定為目前的擁有者，並從範本工作區將下列工作區屬性複寫到新的工作區：mappings 和 comment。 如果未指定名稱，系統會使用以目前計算機名稱為基礎的名稱。 當您使用範本建立工作區時，TFVC 不會從伺服器擷取對應至的檔案。 使用 get 命令，將新的工作區與伺服器上的最新版本同步處理。 如需詳細資訊，請參閱 Get 命令。
單一資料夾對應
您可以選擇只將版本控制資料夾的直接子系對應至本機工作區。 若要這樣做，請在 [新增工作區] 對話方塊中的 [
版本控制階層內的單一文件夾對應很有用，因為它會限制下載到用戶端電腦的項目數目。 限制下載檔的另一種方式是將您不需要在工作區中擁有的檔案遮蓋。 如需詳細資訊，請參閱 優化工作區。 此方法提供更快的下載時間，並節省用戶端電腦上的磁碟空間。
刪除工作區
如果您刪除包含暫止變更的工作區，TFVC 會在刪除程式期間取消暫止的變更。 刪除工作區並不會刪除該工作區中用戶端電腦上的檔案和資料夾。
注意
手動執行的命令需要 /noprompt 選項來略過使用者通知。 如果您使用PowerShell Start() 方法來執行命令，請小心。 您可以在 PowerShell 中自動設定 /noprompt 選項。
刪除工作區時，您需要提供 <workspace-owner> 和 <workspace-name>
您可以使用 workspace 命令來擷取這些值。 如需詳細資訊，請參閱 workspaces 命令。
若要尋找 <workspace-owner> 值，請執行下列命令：
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
若要尋找 <workspace-name> 值，請使用上一個命令輸出中的 <OwnerId> 值作為 <workspace-owner> 值。 該值的格式為 Azure Active Directory （Azure AD） 對象識別碼，後面接著反斜杠和用戶主體名稱。 使用整個值。 然後執行下列命令：
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
若要刪除工作區，請執行下列命令：
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
編輯工作區
您可以變更下列工作區屬性：
- 工作區名稱
- 評論
- 工作資料夾對應
如果未提供任何工作區規格，則會使用目前資料夾的工作區。
例子
下列範例會開啟 [新增工作區] 對話框
c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection
下列範例會建立名為 Beta1 的新工作區，並將 jenh 指派為工作區擁有者。 擁有 AdminWorkspaces 許可權，將新工作區的擁有權指派給其他使用者。 如需安全性權限的詳細資訊，請參閱 預設 TFVC 權限。
c:\projects>tf workspace /new Beta1;jenh
下列範例會使用由 jenh
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
下列範例會從伺服器中移除 Beta1 工作區：
c:\projects>tf workspace /delete Beta1
下列範例會編輯目前工作區的屬性：
c:\projects>tf workspace
下列範例會開啟 Beta1 工作區，該工作區是由 jenh 所擁有，以便查看其屬性和對應。 如果您有 AdminWorkspaces 許可權，您可以變更工作區屬性和對應。
c:\projects> tf workspaces Beta1;jenh