取消標籤指令 （Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） unlabel 命令會從版本控制伺服器中的現有標籤中移除專案。
必要條件
若要使用 unlabel 命令，您必須擁有標籤，或將 [管理標籤 ] 權限設定為 [允許]。 如需詳細資訊，請參閱 預設 TFVC 許可權。
語法
tf unlabel [/collection:<team-project-collection-url>] [/recursive] [/login:<username>, [<password>]] <label-name> <item-specification>
參數
下列各節說明 命令的 unlabel 自變數和選項。
引數
Argument
說明
<team-project-collection-url>
指定專案集合的網址，包含您要從現有標籤移除的專案， 例如 https://myserver:8080/tfs/DefaultCollection。
<label-name>
指定要從指定專案中移除的標籤名稱。
<item-specification>
識別要從中移除指定標籤的檔案或資料夾。 如需 TFVC 如何剖析專案規格以判斷哪些專案在範圍內的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
注意
您可以指定多個項目規格自變數。
<username>
提供 選項的值 /login 。 您可以指定此值指定為 DOMAIN\<username> 或 <username>。
<password>
提供 選項的值 /login 。
選項。
| 選項 | 描述 |
|---|---|
/recursive |
從特定目錄中的所有項目移除指定的標籤，以及符合專案規格的所有子目錄。 |
/collection |
指定專案集合。 |
/login |
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。 |
備註
unlabel命令行公用程式的命令tf會從 Azure DevOps 伺服器中的現有標籤中移除專案。 如需標籤的簡介，請參閱 使用標籤來擷取檔案的快照集。 如需如何將標籤指派給一組檔案和資料夾的相關信息，請參閱 Label 命令 （Team Foundation 版本控制）。
如果您從 Azure DevOps 伺服器的標籤中移除所有專案，則會刪除該標籤。 您也可以使用 tf label /delete 命令來刪除標籤。 如需系統中現有標籤的詳細資訊，請參閱 Labels 命令。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用Team Foundation版本控制命令。
範例
下列範例會從 314.cs 移除 goodbuild 標籤：
c:\projects>tf unlabel goodbuild $/src/314.cs
下列範例會 從 集合中的所有檔案和資料夾移除 Beta1 標籤： https://myserver:8080/tfs/DefaultCollection：
c:\projects>tf unlabel Beta1 $/ /collection:https://myserver:8080/tfs/DefaultCollection /recursive