標籤指令 (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