命令行语法 (Team Explorer Everywhere)
现在您已安装 针对 Team Foundation Server 的跨平台命令行客户端。但,在您键入所有命令之前,您需要了解泛型语法和用法信息。
主题内容
指定选项
在 UNIX 计算机上,绝对路径以一个正斜杠 (/) 开始,因此可以使用连字符 (-) 启动选项。否则,针对 Team Foundation Server 的跨平台命令行客户端 不能辨别路径和选项。
引用和转义
Unix shell 支持许多通配符的特殊字符及正则表达式等。如果那些参数包含 shell 认为特殊的字符,则您必须退出或引用参数给命令。您可以标记在 UNIX 外壳程序中的文本如下所示:
若要保留字符的文本值,请在该字符前面加上反斜杠 (\)。例如,
tf checkout -recursive $/Inventory/Client\ Suite/
若要保留封闭字符的文本值,请将文本括在单引号 (" ") 内。Shell 引用与美元符号的变量 ($),并且通配符不展开,如果是在单引号内。例如,
tf checkout -recursive ‘$/Inventory/Client Suite/’
若要保留封闭字符的文本值(除外,$、\ 和 !),请将文本括在双引号 (" ") 内。
由于这些异常,变量展开,subshells 仍会计算,反斜杠仍可用于转义字符,历史记录事件仍会扩展。以下示例显示仍需防止反斜杠!从展开到历史记录事件。
tf checkin -comment:”Fixed the bug\!” file.java
Visual Studio Team Foundation Server 的服务器路径以美元符号启动,但是,UNIX 外壳程序将美元符号开始变量的扩展。Shell 希望嘘、ksh、大扫除,并且,zsh 在发生的服务器路径视为字符,在美元符号不是有效的变量名之后。因此,这些 shell 将美元符号传递到未更改的 针对 Team Foundation Server 的跨平台命令行客户端。
但是,从 csh 派生的 shell(包括 tcsh)无法以这种方式分析命令行。这些 shell 读取美元符号并尝试替换匹配后面文本的变量。由于下面的文本是反斜杠 (/) 和这些 shell 要求变量名称以字母开头,将出现错误。如果使用 csh 或 tcsh shell,您必须在服务器路径中通过反斜杠或单引号标记转义美元符号。双引号引起 shell 尝试展开变量。这是一些 csh shell 的转义和引用示例:
tf checkout -recursive \$/Inventory/Client\ Suite/
tf checkout -recursive ‘$/Inventory/Client Suite/’
tf checkout -recursive \$”/Inventory/Client Suite/”
项规范
项规范是描述是 针对 Team Foundation Server 的跨平台命令行客户端 的选项或命令的一个输入参数的一个文件或文件夹的本地或服务器路径。项规范可能包含版本规范后缀,由分号分隔。此后缀是可选的。仅当要引用的项目时,的一个历史的版本指定后缀。
示例项规范。
项规范 |
描述 |
---|---|
$/Inventory/src |
文件夹的服务器路径 |
$/Inventory/src/Class.java |
文件的服务器路径 |
/tmp/Inventory |
工作文件夹的本地路径 (Unix) |
/tmp/Inventory/src/Class.java |
文件的本地路径 (Unix) |
C:\Inventory\src |
工作文件夹的本地路径 (Windows) |
C:\Inventory\src\Class.java |
文件的本地路径 (Windows) |
$/Inventory/src;C4095 |
变更集 4095 的文件夹的服务器路径 |
.\Class.java;C129 |
变更集 129 文件的相对本地路径 (Windows) |
./Class.java;Lrelease-1.0 |
标签发布-1.0 处文件的相对本地路径 (Unix) |
$/Inventory/src/file.txt;Wdev;john |
拥有的dev 工作区中版本的服务器路径归 John 所有。 |
file.txt;D01/01/2007 |
2007 年 1 月 1 日的本地路径
说明
支持 ISO 8601 日期。日期根据用户的区域设置分析。
|
file.txt;X1067 |
deletionID 为 1067 的以前删除的文件 |
版本规范
版本规范是引用特定唯一版本或在版本控制中项目版本的特定地格式化字符串。通过两种方式使用“版本规范”:作为项规范的后缀(请本节前面部分的 Item Specifications),以及作为特定命令的 -version 选项的独立值。
示例版本规范。
“版本规范格式” |
描述 |
---|---|
T |
最新版本。 |
Cn |
在变更集 n 的版本。 |
LlabelID |
在标签 labelID 的版本。 |
W名称;所有者 |
在 所有者 拥有的工作区 名称 中的当前版本。 |
Ddatestring |
在 datestring 中指定的日期和时间版本 |
XdeletionID |
删除该版本,并由服务器给定 deletionID。 |