命令行语法 (Team System)

项目
08/18/2008

更新：2007 年 11 月

tf.exe 命令行实用工具的语法。

tf command item [/options]

本主题描述文档约定、命令快捷方式、特殊命令行字符以及 Team Foundation 专用参数（versionspec 和 itemspec）。

文档约定

[/Brackets] 表示不是完成命令所必需的选项。不带括号的项表示完成操作所必需的参数。例如，在下面的命令中，itemspec 是必需的，而 /recursive 则是可选的：

语法示例： c:\projects>tf getitemspec [/recursive]

实际命令： c:\projects>tf get c:\projects /recursive

替代命令： c:\projects>tf get /recursive

在“替代命令”示例中，Team Foundation 将认为您希望获取当前目录 c:\projects 及其所有子文件夹中的内容。因此，虽然 itemspec 参数是必需的，但您不必键入它。

当两个用竖线 (|) 分隔的选项用一对括号括起来时，您可以指定其中一个选项，但不能同时指定两个选项。例如，tf Changeset [/comment:comment|@commentfile] 表示您可以为变更集键入注释，该注释的位置在 /comment: 选项的后面；或者键入 (|)，您可以使用 **@**commentfile 语法指定包含要使用的注释的文件的路径。但是，您不能同时指定 comment 和 commentfile。

在语法示例中，“斜体”项表示参数，您必须将其替换为实际字符才能执行命令。粗体项是包含原义字符串的选项。例如：

语法示例：tf shelvesetsshelvesetname [/recursive]

实际命令：c:\projects>tf shelvesets BuddyTest_23

特殊命令行字符

您可以使用“@”字符（即命令行开关）来同时执行一组 Team Foundation 命令。在命令提示符、命令文件、批处理文件或脚本文件中使用命令行开关的主要好处是：相对于依次执行多个命令，使用命令行开关的速度会大幅度提高。有关更多信息，请参见命令行选项。

命令快捷方式和别名

tf 命令行实用工具支持下列已定义的命令快捷方式和别名：

del = 删除
diff = 差异
edit = 签出
hist = 历史记录
perm = 权限
prop = 属性
ren = 重命名
rename = 移动
stat = 状态
undel = 取消删除

有关这些命令的更多信息，请参见 Tf 命令行实用工具命令。

Team Foundation 如何分析 Itemspec 和 Versionspec

Itemspec 路径

Itemspec 是项规范 (item specification) 的缩写形式，由一个或多个字符组成。Team Foundation 将这些字符解析为一个或一组项，这些项引用映射到工作区或版本控制服务器的文件系统或 UNC 路径。

对于接受 itemspec 的所有 Team Foundation 命令，您可以指定本地文件路径（如 c:\projects）、UNC 路径（如 \\myshare\projects）或服务器路径（如 $/projects/myfiles）。

对于本地路径，您可以提供相对路径。例如，如果当前目录为 c:\projects，而您希望签出 projects 文件夹的一个子目录中的所有项，可以键入 tf checkout .\* /recursive。

说明：
在 Team Foundation 版本控制命令中，您可以使用通配符，例如：*、? 和 #。

如果 itemspec 指定一条服务器路径，则该路径必须是完全限定路径。例如，不能使用 ./* 作为 itemspec 来签出 $/projects 文件夹下的所有项。

Versionspec

“Versionspec”指定要使用的项的版本。在命令中指定版本时，可以将 Versionspec 作为版本选项的一部分添加进去（如 /version:C1256），也可以在文件名后面附加 Versionspec，它们之间用分号分隔（如 filename;Lmylabel）。

使用下面的一个或多个模式来指定版本。

Versionspec	说明
Changeset	属于变更集编号 changeset 的版本。示例：C1256。
Llabel	属于标签 label 的版本。示例：Lmylabel。
Dyyyy-mm-ddTxx:xx - 或 - Dmm/dd/yyyy - 或 - .NET Framework 支持的任何格式。 - 或 - 本地计算机的任何日期格式。	可以由 .NET Framework 方法分析的任何日期和时间格式。示例：D2008-01-21T16:00。有关支持的日期和时间格式的更多信息，请参见 .NET Framework 类库中的 DateTime Structure（DateTime 结构）。
W	最后使用 get 命令检索到工作区的版本。
T	最新修订号。

在使用 History、Difference 或 Merge 命令时，可以通过用波形符 (~) 分隔版本来指定版本范围。请参见下面的示例，了解如何通过用波形符分隔版本来指定范围。

仅查看变更集 137 的 Form1.cs 文件的历史记录。

语法示例：**tf history /version:**C137~C137

获取 form.cs 文件的变更集 C123 与 C125 之间的区别。

语法示例： tf difference/versionC123~C125 form1.cs。

将第一个变更集至变更集 C125 中的所有版本合并到分支 2 中。

语法示例：**tf merge/version:**C125 branch1 branch2。

请参见

通过