标签命令 (Team Foundation 版本控制)

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制(TFVC)tf labels 命令显示 TFVC 服务器中的标签列表。

先决条件

若要使用 labels 命令,请将 读取 权限设置为 允许 指定标签所附加到的所有文件或文件夹。 如果你有权访问某些文件,但不是标签中引用的所有文件,将显示部分结果。 有关详细信息,请参阅 默认 TFVC 权限

语法

tf labels [/owner:ownername] [/format:(brief|detailed)] 
[/collection:TeamProjectCollectionUrl] [labelname] [/login:username,[password]]

参数

参数

参数

说明

<ownername>

提供一个值,例如 DOMAIN\JuanGo 或仅向 /owner 选项 juango

<labelname>

指定一个字符串,该字符串应用于筛选标签列表。 如果省略此参数,则不会筛选标签名称字段。

<TeamProjectCollectionUrl>

要为其显示标签列表的项目集合的 URL,例如 http://myserver:8080/tfs/DefaultCollection

<username>

/login 选项提供值。 可以将 username 值指定为 DOMAIN\usernameusername

选项

选项

说明

/owner

指定拥有标签的用户的名称。 默认情况下,所有者是应用标签的人员。

/format

使用以下格式之一显示有关指定标签的信息:

  • Brief:包括创建标签、所有者和日期。 这是默认值。
  • Detailed:还包括注释、范围和与每个标签关联的文件和文件夹列表。

/collection

指定项目集合。

/login

指定使用 Azure DevOps 对用户进行身份验证的用户名和密码。

言论

  • labels 命令显示 TFVC 服务器中有关标签的信息。 如果未指定 TFVC 服务器,TFVC 会尝试使用当前目录确定 TFVC 服务器。 如果当前目录未映射到 TFVC 服务器,则必须使用 /s 选项指定一个目录。

  • 默认情况下,结果显示每个标签的标签名称、所有者和创建日期。 如果格式更改为 detailed,则还会显示与每个标签关联的注释和文件和文件夹列表。

  • 有关如何使用 tf 命令行实用工具的详细信息,请参阅 使用 Team Foundation 版本控制命令

例子

以下示例显示用户 jasonj创建的标签列表。

c:\projects> tf labels /owner:jasonj

以下示例显示有关 build1033 标签的信息,并列出在 TFVC 服务器中应用标签的文件和文件夹。

c:\projects> tf labels /format:detailed build1033

以下示例显示 TFVC 服务器中的所有标签,这些标签的 labelnamebuild 开头,并由执行 labels 命令的帐户所有。

c:\projects> tf labels build*