Labels 命令

更新:2007 年 11 月

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

必需的权限

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

tf labels [/owner:ownername] [/format:(brief|detailed)] 
[/server:servername] [labelname]

参数

参数

说明

ownername

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

servername

用户提供的 /server 选项的值。示例:teamfoundation2。

labelname

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

选项

说明

/owner

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

/server

标识 Team Foundation Server。如果要从尚未映射到工作区的目录调用命令,则此选项是必需的。请使用该选项的 /s 快捷方式。

/format

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

  • Brief

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

  • Detailed

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

备注

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*

请参见

概念

信息性命令

参考

命令行语法 (Team System)

Label 命令(Team Foundation 版本控制)

Unlabel 命令

其他资源

Tf 命令行实用工具命令