工作區指令 （Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） workspace 命令可讓您建立、刪除、檢視或修改與工作區相關聯的屬性和對應。
必要條件
- 若要修改或刪除現有的工作區，您必須是擁有者，或擁有全域 管理員 註冊工作區的許可權設定為 [允許]。
- 若要建立工作區，您必須將全域 [建立工作區 ] 權限設定為 [ 允許]。
- 若要為其他使用者建立工作區，您必須將 管理員 ister workspaces 許可權設定為 [允許]。
如需詳細資訊，請參閱 預設 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 自變數和選項。
引數
| Argument | 描述 |
|---|---|
<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使用 命令，將新的工作區與伺服器上的最新版本同步處理。 如需詳細資訊，請參閱 取得命令。
單一資料夾對應
您可以選擇只將版本控制資料夾的直接子系對應至本機工作區。 若要這樣做，請在 [新增工作區] 對話框中的 [原始檔控制資料夾] 方塊中新增星號 \ 通配符，例如 $/folder/*。 否則，根據預設，版本控制資料夾的所有子系都會以遞歸方式對應至本機工作區。
版本控制階層內的單一文件夾對應很有用，因為它會限制下載到用戶端電腦的項目數目。 限制下載檔的另一種方式是將您不需要在工作區中擁有的檔案遮蓋。 如需詳細資訊，請參閱 優化您的工作區。 此方法提供更快的下載時間，並節省用戶端電腦上的磁碟空間。
刪除工作區
如果您刪除包含暫止變更的工作區，TFVC 會在刪除程式期間取消暫止的變更。 刪除工作區並不會刪除該工作區中用戶端電腦上的檔案和資料夾。
注意
手動執行的命令需要 /noprompt 選項來略過使用者通知。 如果您使用PowerShell Start() 方法來執行命令，請小心。 此選項 /noprompt 可以在PowerShell中自動設定。
刪除工作區時，您需要提供 <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 指派為工作區擁有者。 您必須擁有 管理員 Workspaces 許可權，才能將新工作區的擁有權指派給其他使用者。 如需安全性許可權的詳細資訊，請參閱 預設 TFVC 許可權。
c:\projects>tf workspace /new Beta1;jenh
下列範例會使用 jenh 所擁有的 Beta1 工作區作為範本來建立新的工作區：
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
下列範例會開啟 jenh 所擁有的 Beta1 工作區，以便查看其屬性和對應。 如果您有 管理員 Workspaces 許可權，您可以變更工作區屬性和對應。
c:\projects> tf workspaces Beta1;jenh