History 命令

發行項
02/28/2013

顯示一或多個檔案和資料夾的修訂記錄。資料會顯示在 [記錄] 視窗，如果 /noprompt 指定選項在命令提示字元。

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]

參數

參數	描述
/collection: TeamProjectCollectionUrl	指定包含 Team 專案之 Team 專案集合的 URL。例如 http://<伺服器名稱>:8080/tfs/DefaultCollection。根據預設， Team 專案集合是假設為包含現在對應路徑的工作區的那項。
/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 (版本在工作區 Client Area)。如需語法資訊，請參閱 Team Foundation 版本控制命令參考。您無法使用這個選項搭配 /slotmode 選項。

範例

取得單一檔案的記錄

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

取得所有項目記錄在資料夾中。

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

顯示儲存至所有項目SolutionA (包括子資料夾)所做的任何變更，在 [記錄] 視窗中。

取得前五個不同的記錄檔中所有項目的資料夾。

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

從 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

從日期 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

取得記錄從 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

取得詳細的記錄檔

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.

取得資料夾的非遞迴記錄

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

在記錄視窗檢視顯示 SolutionA 資料夾的記錄，可讓您瀏覽至資料夾的較早的變更。例如，如果這個資料夾中的最新變更為您要重新命名的物件，您可以展開變更集查看重新命名之前發生的變更。

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

顯示 SolutionA 資料夾最近的變更，在命令提示字元視窗。

Visual Studio 的運作

取得項目的歷程記錄使用 Visual Studio 取得修訂記錄。

秘訣

如需如何使用 [歷史記錄] 視窗的詳細資訊，請參閱取得項目的歷程記錄。
取得與變更集詳細資料 (例如，如果您要查看相關工作項目):
- 在 [記錄] 視窗中，按兩下變更集或開啟捷徑功能表並選取 [變更集詳細資料]。
- 若要從命令提示字元，請使用 Changeset Command。
如需這些變更集的詳細資訊，請參閱尋找和檢視變更集。
/collection 選項執行此命令，適用從沒有工作區對應至 Team 專案集合中項目的電腦和使用者帳戶。
請參閱檢視和管理過往的版本。

共用方式為