Label 命令（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>

为 /owner 选项提供 DOMAIN\JuanGo 或 juango 等值。

<itemspec>

标识要从中标记、重新标记或修改的文件或文件夹。 若要详细了解 TFVC 如何分析 itemspec 以确定哪些项在范围内，请参阅使用 Team Foundation 版本控制命令。

注意

可指定多个 itemspec 参数。

<versionspec>

为 /version 选项提供一个值，例如 c2。 若要详细了解 TFVC 如何分析版本规范以确定哪些项在其范围内，请参阅使用 Team Foundation 版本控制命令。

<comment>

用户提供的关于标签的注释。

@<commentfile>

用户提供的磁盘上文件的路径，其中包含要用于标签的注释。

<username>

为 /login 选项提供值。 可将用户名值指定为 DOMAIN\username 或 username。

<TeamProjectCollectionUrl>

包含要在其中附加或删除标签的文件或文件夹版本的指定项目集合的 URL，例如 http://myserver:8080/tfs/DefaultCollection。

选项

选项

说明

/owner

指定拥有标签的用户的名称。

/version

可选。 指定应在其中附加、修改或移除标签的文件或文件夹的版本。 这些是变更集值，例如 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 命令从系统中删除标签。

如需了解包含已附加标签的项的列表、其注释、范围和所有者的现有标签，请参阅 Labels 命令。

管理重载的标签

标签名称在整个指定范围内必须是唯一的。 添加标签时，将该标签名称保留为仅在指定或隐含的范围内使用。 @scope 参数的默认值为项目，例如 $/TeamProject1。

如果另一个团队或用户将通用标签（例如 M3）添加到 TFVC 服务器不同部分中的一组受版本控制的文件，则只要根项目文件夹位于不同的目录中，就可以将 M3 标签应用于项目中受版本控制的文件。 例如，如果 $/math 目录中的文件标记为 M3，则还可将 M3 标签应用于 $/projects 目录中的文件。

若要获取、移除标签或以其他方式管理带 M3 标签的项，应指定 @scope 参数以告知 TFVC 你希望使用哪个 M3 标签。

可通过在 Team Foundation 版本控制服务器的根 $/ 上创建标签，或通过调整某些文件夹的标签权限，来防止其他用户在 TFVC 服务器的不同部分“重载”标签，例如 M3。

示例

以下示例将 goodbuild 标签附加到 docs 文件夹的工作区版本及其包含的文件和文件夹。

c:\projects>tf label goodbuild docs /recursive

以下示例将 goodbuild 标签附加到 docs 文件夹，但不附加到 docs 文件夹包含的文件和文件夹。

c:\projects>tf label goodbuild docs

以下示例将 goodbuild 标签附加到 TFVC 服务器中的 314.cs 版本 3。

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