History 命令

显示一个或多个文件或文件夹的修订历史记录。该数据显示在"历史记录"窗口,或者,如果 /noprompt 选项,在命令提示。

要求: 请参见 Team Foundation Server 权限.

tf hist[ory] itemspec [/version:versionspec] 
[/stopafter:number] [/recursive] [/user:username] 
[/format:(brief|detailed)] [/slotmode] [/itemmode] [/noprompt]
[/login:username,[password]] [/sort:ascending,descending]
[/collection:TeamProjectCollectionUrl]

参数

Parameter

说明

/collection: TeamProjectCollectionUrl

指定包含项目的团队项目集合的URL。例如:http://myserver:8080/tfs/DefaultCollection。

默认情况下,团队项目集合将假定为包含工作区映射当前目录的配置。

/format

指定显示的详细程度。有关每个变更集,当 /noprompt 选项指定:

  • Brief (默认值):显示有关所包括的每个变更集的一行:ID号,所做的更改,作出更改、日期和注释的用户。某些数据可能会被截断。

  • Detailed:显示每个变更集的完整说明。除了上面的信息外,此选项卡来显示不同的数据(例如使用时间的日期,项目已更改的,签入说明和签入策略警告。

/itemmode

不能将此选项与 /slotmode 选项一起使用。和Mitrik:更改在TFS 2010年版本控制的槽模式参见。

itemspec

指定可以显示历史记录的项目。有关语法,请参见 Team Foundation 版本控制命令参考

/noprompt

此选项:

  • 禁止显示窗口和对话框显示(例如 历史记录 窗口)并将输出重定向到数据命令提示。请参见 Team Foundation 版本控制命令参考

  • 不显示发生版本的历史记录,在项目中移动了,已重命名,分支和合并之前。

/login:username,[password]

指定用户帐户运行命令。请参见 Team Foundation 版本控制命令参考

/recursive

递归检索有关项的历史数据将在指定的目录和所有子目录。

/slotmode

不能将此选项与 /itemmode 选项一起使用。和Mitrik:更改在TFS 2010年版本控制的槽模式参见。

/sort

按以下顺序对一个或多个文件或文件夹的修订历史记录进行排序:

  • Ascending:从最旧到最新版本。

  • Descending (默认值):最近到最早的版本。

您必须使用此选项的 /noprompt 选项。

/stopafter:number

在历史记录数据中指定变更集的最大数量显示。

/user:username

筛选历史数据显示所指定的用户所做的更改。星号(*)符号包括有关更改的数据从所有用户(默认值)。

/version:versionspec

在历史记录数据指定下列限制之一:

  • 最大版本

  • 使用范围 ~ 语法的最小日期和最大版本。

默认值为 /version:W (版本在工作站)。

有关语法,请参见 Team Foundation 版本控制命令参考

不能将此选项与 /slotmode 选项一起使用。

示例

yxtbh4yh.collapse_all(zh-cn,VS.110).gif单个文件中获取历史记录

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs

显示做的任何更改将在program.cs "历史记录"窗口上。

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs /noprompt

显示做的任何更改将在program.cs在命令提示符窗口上。例如:

Changeset Change                     User              Date       Comment
--------- -------------------------- ----------------- ---------- -------- 
29        edit                       Peter Waxman      4/23/2012  Fix bug
20        add                        Julia Ilyina      4/12/2012  Add new  

yxtbh4yh.collapse_all(zh-cn,VS.110).gif所有项目中获取历史记录文件夹中

c:\code\SiteApp\Main\SolutionA>tf history * /recursive

在SolutionA显示所做的任何更改将所有项目(包括那些位于子文件夹中)在"历史记录"窗口中。

yxtbh4yh.collapse_all(zh-cn,VS.110).gif前五个不同的获取历史记录的任何项目的文件夹中。

c:\code\SiteApp\Main\SolutionA>tf history * /noprompt /recursive /stopafter:5

在SolutionA中显示所做的最新的5个对项目(包括那些位于子文件夹中):

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
31        Julia Ilyina      5/15/2012
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to Proje
15        Julia Ilyina      4/8/2012

yxtbh4yh.collapse_all(zh-cn,VS.110).gif从第x版获取历史记录和。

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:30

使的显示对所有项目在SolutionA (包括那些位于子文件夹中)在30版上和早期:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to 15        Julia Ilyina      4/8/2012

yxtbh4yh.collapse_all(zh-cn,VS.110).gif 从日期D中获取历史记录和。

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/24/2012

--或者--

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D2012-04-24T12:00

使的显示对所有项目在SolutionA (包括那些位于子文件夹中) 4/23/12上或早期版本:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to 15        Julia Ilyina      4/8/2012

yxtbh4yh.collapse_all(zh-cn,VS.110).gif从第x版获取历史记录到版本y

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

使的显示对所有项目在SolutionA上(包括那些位于子文件夹中)在4/12/2012和4/23/12内:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to 

yxtbh4yh.collapse_all(zh-cn,VS.110).gif获取详细历史记录

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012 /format:detailed

有关所做的更改的显示详细信息对所有项目在SolutionA上(包括那些位于子文件夹中)在4/12/2012和4/23/12内:

-------------------------------------------------------------------------------
Changeset: 30
User: Julia Ilyina (Fabrikam)
Date: Monday, April 23, 2012 1:23:05 PM

Comment:
  Much better name for this file

Items:
  rename                $/SiteApp/Main/SolutionA/Project1/programBig.cs
  delete, source rename $/SiteApp/Main/SolutionA/Project1/program3.cs;X15

-------------------------------------------------------------------------------
Changeset: 29
User: Julia Ilyina (Fabrikam)
Date: Monday, April 23, 2012 1:03:13 PM

Comment:
  Fix bug in new method

Items:
  edit $/SiteApp/Main/SolutionA/Project1/program1.cs
  edit $/SiteApp/Main/SolutionA/Project1/program2.cs

-------------------------------------------------------------------------------
Changeset: 20
User: Julia Ilyina (Fabrikam)
Date: Thursday, April 12, 2012 5:09:35 PM

Comment:
  Add new method, add program2.cs to Project1

Items:
  add $/SiteApp/Main/SolutionA/Project1/program2.cs


Check-in Notes:
  Documentation:
    An important new part of our codebase.

Policy Warnings:
  Override Reason:
    Peter agrees with me that we can bypass for this check-in.
  Messages:
    The Code Analysis Policy requires files to be checked in through Visual
Studio with an open solution.

yxtbh4yh.collapse_all(zh-cn,VS.110).gif获取文件夹的非递归历史记录

c:\code\SiteApp\Main\SolutionA>tf history .

显示SolutionA文件夹的历史记录在"历史记录"窗口中,可以测试到文件夹的早期更改。例如,在中,如果对该文件夹的最新更改是重命名,可以展开变更集才能在重命名之前发生的更改。

c:\code\SiteApp\Main\SolutionA>tf history . /noprompt

显示给SolutionA文件夹的最新更改在命令提示符窗口上。

Visual Studio 中的工作

提示

  • 提示 有关如何使用 历史记录 窗口的信息,请参见 获取某项的历史记录

  • 提示 有关变更集的访问详细信息(例如,若要查看关联的工作项):

    • 在"历史记录"窗口中,双击变更集或打开其快捷菜单中选择 *** 变更集详细信息 ***

    • 从命令提示,请使用 Changeset Command

  • 提示 有关变更集的更多信息,请参见 查找和查看变更集

  • 提示/collection 选项用于运行来自没有工作区映射到团队项目集合包含项目的计算机和用户帐户的此命令才有用。

  • 提示 请参见 查看和管理过去的版本