History 命令
更新：2007 年 11 月
显示一个或多个文件和文件夹的修订历史记录。
必需的权限
若要使用 history 命令，您必须针对请求其历史记录的所有文件或文件夹将“读”权限设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。
tf history [/server:servername] itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/noprompt]
参数
参数 |
说明 |
|---|---|
servername |
用户提供的 /server 选项的值。示例：teamfoundation2。 |
itemspec |
标识要显示历史记录的文件或文件夹。有关 Team Foundation 如何分析项规范以确定哪些项在范围之内的更多信息，请参见命令行选项。 |
versionspec |
为 /version 选项提供值（如 C58）。有关 Team Foundation 如何分析版本规范以确定哪些项在其范围内的更多信息，请参见命令行语法 (Team System)。 |
number |
指定历史记录查询中应包括多少变更集。 |
username |
向 /user 选项提供值。根据网络设置，可以指定域\用户名或用户名。 |
选项 |
说明 |
|---|---|
/server |
标识 Team Foundation Server。如果从未映射到工作区的目录调用命令，则此选项是必需的。 |
/version |
指定要显示修订历史记录的项的版本。默认情况下，Team Foundation 使用工作区版本。 不能将此选项与 /slotmode 选项一起使用。 |
/stopafter |
显示指定变更集数 (number) 的历史记录。例如，/stopafter:10 显示指定项的最后十个更改。 |
/recursive |
检索有关指定路径下的项的历史记录信息。 |
/user |
筛选对指定用户的更改列表。星号 (*) 可以用来选择所有用户。如果未指定，则选择所有用户。 |
/format |
指定为历史记录信息所显示的说明。 Brief 为每个变更集显示一行。Detailed 显示变更集的完整说明。如果未指定，则为简短说明。 |
/slotmode |
显示曾经占用过指定命名空间位置的所有项的修订历史记录。 |
/noprompt |
取消显示需要您输入的任何提示。 |
备注
history 命令打开“历史记录”窗口，该窗口显示要选择的按钮：“详细信息”、“视图”和“比较”。“详细信息”显示变更集的详细信息。“视图”显示文件的版本。“比较”会将文件版本与您的当前工作区版本（如果只选择一行的话）或两个不同的版本（如果选择两行的话）进行比较。在“历史记录”窗口的上下文菜单中，使用 copy 选项将当前选定行中的文本信息复制到剪贴板。有关更多信息，请参见了解“历史记录”窗口。
可以使用 history 命令显示一个或多个文件和文件夹的修订历史记录。对于每一个包括所请求的项的变更集，Team Foundation 在变更集输出中显示修订项。变更集详细信息包括如下信息：将更改提交到 Team Foundation 版本控制 服务器的用户、提交了挂起更改的文件和文件夹、提交的挂起更改的类型、变更集号以及创建变更集的日期和时间。
如果未提供 版本规范，则 Team Foundation 显示文件或文件夹的完整历史记录。提供单个版本规范时，Team Foundation 显示有关从该版本一直往前到版本 1 的项的信息。如果指定版本范围（使用 ~ 语法），则显示这些版本以及中间所有版本的历史记录。可以按升序或降序指定范围。
如果您包括 /slotmode 选项，Team Foundation 会显示指定项的修订历史记录。例如，如果您重命名了某个文件，则此选项会显示该文件的旧名称和新名称。. 因为 /slotmode 选项指定完全不同的项和版本的范围，所以不应结合 /slotmode 和 /version 选项。
可以使用 history 命令确定提交了一组文件的变更集号，然后使用 changeset 命令来显示有关变更集以及创建该变更集的签入的性质的更多详细信息。或者，可从“历史记录”窗口中选择一行，然后单击“详细信息”按钮。
有关指向其他 Team Foundation 命令的链接（这些命令提供有关 Team Foundation 版本控制 服务器和映射到该服务器的工作区中的项的其他信息），请参见信息性命令。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例显示 1256.c 在变更集版本 5 和变更集版本 8 之间所发生的更改。
c:\projects> tf history /version:C5~C8 1256.c
下面的示例显示 314.cs 所发生的最后十个更改。
c:\projects> tf history /stopafter:10 314.cs
下面的示例显示 1256.c 命名空间槽的详细输出格式的历史记录。
c:\projects> tf history /format:detailed/slotmode 1256.c