Labels 命令(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]]

参数

参数

Argument

说明

<ownername>

/owner 选项提供 DOMAIN\JuanGojuango 等值。

<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 选项来指定一个 TFVC 服务器。

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

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

示例

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

c:\projects> tf labels /owner:jasonj

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

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

以下示例显示 TFVC 服务器中具有以 build 开头的 labelname 并且由执行 labels 命令的帐户拥有的所有标签。

c:\projects> tf labels build*