標籤指令 （Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） tf label 命令會將標籤附加至 TFVC 伺服器中檔案或資料夾的版本，或移除標籤。
必要條件
若要使用 label 命令，您必須將 [卷標 ] 權限設定為 [允許]。 若要修改或刪除其他使用者所建立的標籤，您必須將 管理員 註冊標籤限設定為 [允許]。 如需詳細資訊，請參閱 預設 TFVC 許可權。
語法
tf label labelname[@scope] [/owner:ownername]
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)]
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
tf label /delete labelname[@scope]
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
參數
引數
Argument
說明
<labelname>
識別要從指定專案附加、修改或移除的標籤名稱。
@<scope>
指定 TFVC 伺服器目錄，其中是唯一的 labelname 。 當同名的兩個標籤位於 TFVC 伺服器的不同部分時，此參數可讓您獨立建立、管理、擷取和刪除一組標籤或一組已標記的專案。
<ownername>
提供或等juango值DOMAIN\JuanGo給 /owner 選項。
<itemspec>
識別要從中標記、重新標記或修改的檔案或資料夾。 如需 TFVC 如何剖析 itemspec 以判斷哪些專案在範圍內的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
注意
您可以指定多個 itemspec 自變數。
<versionspec>
提供 選項的值，例如 c2 /version 。 如需 TFVC 如何剖析版本規格以判斷其範圍內哪些專案的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
<comment>
使用者提供的標籤批註。
@<commentfile>
磁碟上檔案的使用者提供路徑，其中包含要用於標籤的批註。
<username>
提供 選項的值 /login 。 您可以將使用者名稱值指定為 DOMAIN\username 或 username。
<TeamProjectCollectionUrl>
指定之項目集合的網址，包含您要附加標籤或從中移除標籤的檔案或資料夾版本，例如 http://myserver:8080/tfs/DefaultCollection。
選項。
選項
說明
/owner
指定擁有標籤的用戶名稱。
/version
選擇性。 指定標籤應附加、修改或移除標籤的檔案或資料夾版本。 這些是 changeset 值，例如 C93。 根據預設，如果未 versionspec 提供，TFVC 會使用基底工作區版本。
/comment
新增或修改標籤的描述或批註。
/child
未記載。
/recursive
標記目錄中符合和 itemspec versionspec的所有專案。 無法搭配 /delete 選項使用。
/delete
拿掉標籤。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
/collection
指定專案集合。
備註
標籤是一個標記，您可以附加至 TFVC 伺服器中一組其他無關的檔案和資料夾。 使用標籤來簡化工作區的檔案和資料夾擷取，以供開發或建置之用。 標籤就像變更集或日期/時間，您可以從中任意新增和移除檔案和資料夾，或變更其中專案的版本。 標籤是可傳遞至下列 TFVC 命令的版本規格：
常見的標籤是里程碑標籤，例如 M1、 Beta2或 Release Candidate 0。
標籤是版本特定的。 也就是說，您只能將標籤附加至一個檔案或資料夾的版本。 每個專案版本都可以支援多個標籤。
標籤不是版本設定的物件。 因此，不會追蹤檔案的標籤歷程記錄。 此外，卷標作業不會在您的工作區中建立暫止的變更。 當您發出 label 命令時，更新會立即反映在 TFVC 伺服器中。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用Team Foundation版本控制命令。
拿掉和刪除標籤
您可以使用 Unlabel 命令 ，從檔案或資料夾移除標籤。 或者，您可以使用 命令，從系統 tf label /delete 刪除標籤。
如需現有標籤的相關信息，其中包含標籤已附加的專案清單、其批註、範圍和擁有者，請參閱 Label 命令。
管理多載標籤
標籤名稱在整個指定範圍中必須是唯一的。 當您新增標籤時，您會在指定的或隱含範圍下保留該標籤名稱的使用。 參數的 @scope 預設值是專案，例如 $/TeamProject1。
如果另一個小組或使用者將一般標籤 M3 新增至 TFVC 伺服器不同部分中的一組版本控制檔案，只要根專案資料夾位於不同的目錄中，您就可以將標籤套用 M3 至專案中的版本控制檔案。 例如，如果 $/math 目錄中的檔案標示為 M3，您也可以將標籤M3套用至 $/projects 目錄中的檔案。
若要取得、移除標籤，或管理標記 M3的專案，您應該指定 @scope 參數來告知 TFVC 您想要使用哪個 M3 標籤。
您可以藉由在 Team Foundation 版本控制伺服器的根$/目錄建立標籤，或調整特定資料夾的標籤限，以防止其他使用者「多載」標籤，例如 M3 TFVC 伺服器的不同部分。
範例
下列範例會將標籤goodbuild附加至 docs 資料夾的工作區版本，以及它所包含的檔案和資料夾。
c:\projects>tf label goodbuild docs /recursive
下列範例會將goodbuild標籤附加至 docs 資料夾，但不會附加至 docs 資料夾所包含的檔案和資料夾。
c:\projects>tf label goodbuild docs
下列範例會將標籤 goodbuild 附加至 TFVC 伺服器中第 3 版 314.cs 。
c:\projects>tf label goodbuild /version:3 $/src/314.cs
下列範例會從 TFVC 伺服器中的所有專案刪除標籤 badbuild 。
c:\projects>tf label /delete badbuild
下列範例使用 @ 範圍選項將標籤套用至 314.cs。
c:\projects>tf label goodbuild@$/TeamProject1 314.cs