History 命令
為一個或多個檔案、資料夾或這兩者顯示修訂記錄。
必要的使用權限
若要使用 history 命令，您必須將要求記錄之所有檔案或資料夾的 [讀取] 權限設定為 [允許]。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf history itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/itemmode] [/noprompt] [/login:username,[password]] [/sort:ascending,descending] [/collection:TeamProjectCollectionUrl]
參數
引數 |
描述 |
|---|---|
itemspec |
辨別要為其顯示記錄的檔案或資料夾。 如需 Team Foundation 如何剖析項目規格以判斷哪些項目位於範圍內的詳細資訊，請參閱命令列選項。 |
versionspec |
提供 /version 選項的值 (例如 C58)。 如需 Team Foundation 如何剖析版本規格以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (版本控制)。 |
number |
指定應該要在記錄查詢中包含多少變更集。 |
TeamProjectCollectionUrl |
Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection)，該集合包含一個或多個要為其顯示相關修訂記錄的檔案或資料夾。 |
username |
提供 /login 和 /user 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
選項 |
描述 |
|---|---|
/version |
指定針對其顯示修訂記錄的項目的版本。 依預設，Team Foundation 會使用工作區版本。 您無法使用這個選項搭配 /slotmode 選項。 |
/stopafter |
顯示您指定的變更集編號的歷程記錄。 |
/recursive |
擷取指定路徑之下項目的記錄資訊。 |
/user |
針對具名使用者篩選變更清單。 可以使用星號 (*) 選取所有使用者。 如果未指定，則會選取所有使用者。 |
/format |
指定為記錄資訊所顯示的說明。 Brief 會針對每個變更集顯示一行說明。 Detailed 會顯示變更集的完整說明。 如果未指定，則會顯示簡短的說明。 |
/slotmode |
針對曾佔用指定命名空間位置的所有項目顯示修訂記錄。 如果您已重新命名檔案，此選項會同時顯示檔案在舊名稱與新名稱下的修訂記錄。 |
/noprompt |
抑制任何要求您輸入的提示。 |
/itemmode |
顯示具有唯一路徑之指定項目的修訂記錄。 與選項 /slotmode 不同，如果您已重新命名檔案，此選項只會顯示檔案在新名稱下的修訂記錄。 |
/collection |
指定 Team 專案集合。 |
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
/sort |
依下列任一順序排序一個或多個檔案或資料夾中的修訂記錄：
|
備註
記錄命令會開啟 [記錄] 視窗，顯示出選取 [詳細資料]、[檢視] 和 [比較] 的按鈕。 [詳細資料] 會顯示變更集詳細資料。 [檢視] 則顯示檔案版本。 如果只有選取一列，[比較] 會將檔案版本與目前的工作區版本比較，如果選取兩列，則會與兩個不同的版本比較。 從 [記錄] 視窗的內容功能表使用 copy 選項，將目前選取列中的文字資訊複製到剪貼簿。 如需詳細資訊，請參閱使用記錄視窗。
您可以使用 history 命令，顯示一或多個檔案及資料夾的修訂記錄。 Team Foundation 會針對包含所要求項目的每個變更集，在變更集輸出中顯示修訂項目。 變更集詳細資料包括將變更認可到 Team Foundation 版本控制伺服器的使用者、對其認可暫止變更的檔案和資料夾、認可的暫止變更類型、變更集編號，以及建立變更集時的日期和時間等相關資訊。
如果未提供 versionspec，Team Foundation 會顯示檔案或資料夾的完整記錄。 如果提供了單一版本規格，則 Team Foundation 會顯示項目從該版本到版本 1 的相關資訊。 如果是指定版本範圍 (使用 ~ 語法)，則會顯示這些版本和之間所有版本的記錄。 您可以依遞增或遞減順序指定範圍。
如果搭配使用 /slotmode 選項，Team Foundation 便會顯示指定之項目的修訂記錄。 例如，您已為某個檔案重新命名，則這個選項會顯示舊的名稱和新的名稱。 因為 /slotmode 選項是指定分散項目和版本的範圍，所以 /slotmode 不能與 /version 選項結合。
您可以使用 history 命令判斷其中認可了一組檔案的變更集編號，然後使用 changeset 命令顯示更多有關變更集本質以及建立該變更集的簽入作業的詳細資料。 或者，也可以從 [記錄] 視窗選取列，然後按一下 [詳細資料] 按鈕。
如需其他 Team Foundation 命令的連結，內容提供 Team Foundation 版本控制伺服器中項目與對應至此伺服器之工作區的詳細資訊，請參閱可取得資訊的命令。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
範例
下列範例顯示在變更集版本 5 和變更集版本 8 到 1256.c 之間所發生的變更。
c:\projects> tf history /version:C5~C8 1256.c
下列範例顯示 314.cs 所發生的上 10 次變更。
c:\projects> tf history /stopafter:10 314.cs
下列範例顯示 1256.c 命名空間位置的詳細輸出格式化記錄。
c:\projects> tf history /format:detailed /slotmode 1256.c