Labels 命令

显示 Team Foundation 版本控制 服务器中的标签列表。

所需权限

若要使用 labels 命令,您必须针对要附加指定标签的所有文件或文件夹将**“读”权限设置为“允许”**。 如果只对部分而不是所有标签中引用的文件具有权限,则只显示部分结果。 有关更多信息,请参见 Team Foundation Server 权限

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

参数

参数

说明

ownername

/owner 选项提供用户名,如 DOMAIN\JuanGo 或 juango。

labelname

指定要用于筛选标签列表的字符串。 如果省略此参数,则不会筛选标签名字段。

TeamProjectCollectionUrl

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

username

/login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。

选项

说明

/owner

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

/format

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

  • Brief

    包括标签、所有者及其创建日期。 这是默认值。

  • 详细

    还包括注释、范围以及与每个标签关联的文件和文件夹的列表。

/collection

指定团队项目集合。

/login

指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。

备注

labels 命令显示有关 Team Foundation 版本控制 服务器中标签的信息。 如果未指定 Team Foundation 版本控制 服务器,则 团队资源管理器 尝试根据当前目录确定 Team Foundation 版本控制 服务器。 如果当前目录未映射到 Team Foundation 版本控制 服务器,您必须通过使用 /s 选项指定一个服务器。

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

其他 Team Foundation 命令提供关于 Team Foundation 版本控制 服务器以及映射到该服务器的所有工作区中的项的其他信息,相关链接请参见 信息性命令

有关如何查找 tf 命令行实用工具的更多信息,请参见 Tf 命令行实用工具命令

示例

下面的示例显示用户“jasonj”创建的标签列表。

c:\projects> tf labels /owner:jasonj

下面的示例显示有关“build1033”标签的信息,并列出 Team Foundation 版本控制 服务器中应用该标签的文件和文件夹。

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

下面的示例显示 Team Foundation 版本控制 服务器中 标签名 以“build”开头且属于执行 labels 命令的帐户的所有标签。

c:\projects> tf labels build*

请参见

参考

命令行语法(版本控制)

Label 命令(Team Foundation 版本控制)

Unlabel 命令

概念

信息性命令

其他资源

Tf 命令行实用工具命令