命令行语法(版本控制)

tf、Team Foundation 命令行实用工具的语法、命令如下:

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:注释|@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 是项规范的缩写,是 Team Foundation 尝试解析为可寻址项目或一组项的一组一个或多个字符,可能位于计算机上,也可能位于版本控制服务器上。

对于接受 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 的版本。 示例: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 命令下载到您的工作区的版本。

Wworkspacename;workspaceowner

最近使用 get 命令下载到指定工作区的版本。

示例:WResolveRIConflicts;AKerry

T

最新版本。

在使用 HistoryDifference 命令时,可以通过用波形符 (~) 分隔版本来指定版本范围。

请参见

参考

命令行选项

概念

信息性命令

使用搁置集

使用变更集

其他资源

Team Foundation 版本控制命令行参考

Tf 命令行实用工具命令