标签命令 （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]
参数
参数
参数
说明
<labelname>
标识要从指定项附加、修改或删除的标签的名称。
@<scope>
指定一个 TFVC 服务器目录，其中 labelname 是唯一的。 使用此参数，当同名的两个标签位于 TFVC 服务器的不同部分时，可以独立创建、管理、检索和删除一个标签或一组标记的项。
<ownername>
提供一个值，例如 DOMAIN\JuanGo 或仅向 /owner 选项 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 命令从系统中删除标签。
有关包含标签已附加到的项目列表、注释、范围和所有者的现有标签的信息，请参阅 Label 命令。
管理重载标签
标签名称在整个指定范围内必须是唯一的。 添加标签时，请在指定或隐含作用域内保留该标签名称的使用。
@scope 参数的默认值为项目，例如，$/TeamProject1。
如果另一个团队或用户将通用标签（如 M3）添加到 TFVC 服务器不同部分中的一组版本控制文件，只要根项目文件夹位于不同的目录中，就可以将 M3 标签应用于项目中的版本控制的文件。 例如，如果将 $/math 目录中的文件标记为 M3，则还可以将 M3 标签应用于 $/projects 目录中的文件。
若要获取、删除标签或管理 M3标记的项，应指定 @scope 参数，告知 TFVC 要使用的 M3 标签。
可以通过在 Team Foundation 版本控制服务器的根 $/ 上创建标签，或通过调整某些文件夹的标签 标签 权限来防止其他用户“重载”TFVC 服务器的不同部分 M3。
例子
以下示例将 goodbuild 标签附加到 文档 文件夹及其包含的文件和文件夹的工作区版本。
c:\projects>tf label goodbuild docs /recursive
以下示例将 goodbuild 标签附加到 文档 文件夹中，但不附加到 文档 文件夹包含的文件和文件夹。
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