分享方式:


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

提供或等juangoDOMAIN\JuanGo/owner 選項。

<itemspec>

識別要從中標記、重新標記或修改的檔案或資料夾。 如需 TFVC 如何剖析 itemspec 以判斷哪些專案在範圍內的詳細資訊,請參閱 使用 Team Foundation 版本控制命令

注意

您可以指定多個 itemspec 自變數。

<versionspec>

提供 選項的值,例如 c2 /version 。 如需 TFVC 如何剖析版本規格以判斷其範圍內哪些專案的詳細資訊,請參閱 使用 Team Foundation 版本控制命令

<comment>

使用者提供的標籤批註。

@<commentfile>

磁碟上檔案的使用者提供路徑,其中包含要用於標籤的批註。

<username>

提供 選項的值 /login 。 您可以將使用者名稱值指定為 DOMAIN\usernameusername

<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 命令的版本規格:

常見的標籤是里程碑標籤,例如 M1Beta2Release 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