次の方法で共有


[履歴] コマンド (Team Foundation バージョン 管理)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Team Foundation Version Control (TFVC) tf history コマンドは、1 つ以上のファイルまたはフォルダーのリビジョン履歴を表示します。 コマンド データは、Visual Studio の [履歴] ウィンドウに表示されるか、コマンド プロンプトで /noprompt オプションが指定されている場合に表示されます。

Visual Studio を使用してリビジョン履歴を取得することもできます。 詳細については、「項目の履歴を取得する」を参照してください。

前提条件

「既定の TFVC アクセス許可 を参照してください。

構文

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>

項目を含むプロジェクト コレクションの URL を指定します。 (例: http://myserver:8080/tfs/DefaultCollection)。

既定では、プロジェクト コレクションは、現在のディレクトリをマップするワークスペースを含むコレクションと見なされます。

/format

/noprompt オプションを指定した場合に、各変更セットに関して表示する詳細の量を指定します。

  • Brief (既定値): ID 番号、加えられた変更、変更を行ったユーザー、日付、コメントを含む各変更セットに関する 1 行が表示されます。 一部のデータは切り捨てられる可能性があります。

  • Detailed: 各変更セットの完全な説明を表示します。 上記の情報に加えて、このオプションでは、日付と時刻、アイテムの変更、チェックイン ノート、チェックイン ポリシーの警告など、より多くのデータが表示されます。

/itemmode

このオプションを /slotmode オプションと組み合わせることはできません。 詳細については、「Matt Mitrik: TFS 2010 バージョン コントロールのスロット モードに変更する」を参照してください。

<itemspec>

履歴を表示する項目を指定します。 構文については、「Team Foundation バージョン管理コマンド使用する」を参照してください。

/noprompt

[履歴] ウィンドウなどのウィンドウとダイアログ ボックスの表示を抑制し、出力データをコマンド プロンプトにリダイレクトします。 「Team Foundation バージョン管理コマンド使用する」を参照してください。

アイテムが移動、名前変更、分岐、またはマージされる前に発生したリビジョンの履歴は表示されません。

/login:<username>[,<password>]

コマンドを実行するユーザー アカウントを指定します。 「Team Foundation バージョン管理コマンド使用する」を参照してください。

/recursive

指定したディレクトリおよびサブディレクトリ内の項目に関する履歴データを再帰的に取得します。

/slotmode

このオプションを /itemmode オプションと組み合わせることはできません。 詳細については、「Matt Mitrik: TFS 2010 バージョン コントロールのスロット モードに変更する」を参照してください。

/sort

1 つ以上のファイルまたはフォルダーのリビジョン履歴を次のいずれかの順序で並べ替えます。

  • Ascending: 最も古いものから最新のリビジョンまで。

  • Descending (既定値): 最新のリビジョンから最も古いリビジョンまで。

このオプションでは、/noprompt オプションを使用する必要があります。

/stopafter:<number>

履歴データに表示する変更セットの最大数を指定します。

/user:<username>

履歴データをフィルター処理して、指定したユーザーによって行われた変更を表示します。 アスタリスク (*) 記号には、すべてのユーザーからの変更に関するデータ (既定値) が含まれます。

/version:<versionspec>

範囲 ~ 構文を使用して、最大バージョン、または最小バージョンと最大バージョンのいずれかを指定します。 既定値は、ワークスペース内のバージョン /version:Wです。

このオプションを /slotmode オプションと組み合わせることはできません。

構文については、「Team Foundation バージョン管理コマンド使用する」を参照してください。

注釈

  • 関連する作業項目を表示するなど、変更セットに関する詳細情報を取得するには:

    • Visual Studio 履歴 ウィンドウで、変更セットをダブルクリックまたは右クリックし、[変更セットの詳細] 選択します。

    • コマンド プロンプトから、Changeset コマンドを使用します。

  • /collection オプションは、項目を含むプロジェクト コレクションにマップされたワークスペースがないコンピューターとユーザー アカウントからこのコマンドを実行する場合に便利です。

例示

次の例では、c:\code\SiteApp\Main がワークスペース内のメイン フォルダーにマップされることを前提としています。

1 つのファイルの履歴を取得する

次の使用例は、[履歴] ウィンドウに program2.cs に加えられたすべての変更を表示します。

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

次の使用例は、コマンド プロンプト ウィンドウに program2.cs に加えられたすべての変更を表示します。

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

アウトプット:

Changeset Change                     User              Date       Comment
--------- -------------------------- ----------------- ---------- -------- 
29        edit                       Jamal Hartnett    4/23/2012  Fix bug
20        add                        Raisa Pokrovskaya 4/12/2012  Add new  

フォルダー内のすべてのアイテムの履歴を取得する

次の使用例は、SolutionAのすべての項目に加えられたすべての変更 (サブフォルダーを含む) を 履歴 ウィンドウに表示します。

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

フォルダー内のすべてのアイテムに対する過去 5 回の変更の履歴を取得する

次の例では、コマンド プロンプト ウィンドウに、SolutionA内の項目に加えられた最新の 5 つの変更 (サブフォルダーを含む) を表示します。

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

アウトプット:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
31        Raisa Pokrovskaya 5/15/2012
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to Proje
15        Raisa Pokrovskaya 4/8/2012

バージョン x 以前から履歴を取得する

次の例では、SolutionA内のすべての項目 (バージョン 30 以前のサブフォルダーを含む) に加えられた変更をコマンド プロンプト ウィンドウに表示します。

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

アウトプット:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 
15        Raisa Pokrovskaya 4/8/2012

日付 D 以前から履歴を取得する

次の例では、コマンド プロンプト ウィンドウで、SolutionA内のすべての項目 (サブフォルダー内のアイテムを含む) に加えられた変更を 4/23/12 以前に表示します。

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

アウトプット:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 15        Raisa Pokrovskaya 4/8/2012

日付の範囲から履歴を取得する

次の例では、SolutionA内のすべての項目 (サブフォルダー内の項目を含む) に対して、2012 年 4 月 12 日から 2012 年 4 月 23 日までの間に行われた変更をコマンド プロンプト ウィンドウに表示します。

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

アウトプット:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 

詳細な履歴を取得する

次の例では、2012 年 4 月 12 日から 2012 年 4 月 23 日までの間に、SolutionA内のすべての項目に加えられた変更の詳細をコマンド プロンプト ウィンドウに表示します。

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

アウトプット:

-------------------------------------------------------------------------------
Changeset: 30
User: Raisa Pokrovskaya (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: Raisa Pokrovskaya (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: Raisa Pokrovskaya (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:
    Jamal 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.

フォルダーの非再帰履歴を取得する

次の例では、SolutionA フォルダーの履歴を Visual Studio 履歴 ウィンドウに表示します。これにより、フォルダーに対する以前の変更を調べることができます。 たとえば、フォルダーに対する最新の変更が名前変更であった場合は、変更セットを展開して、名前の変更前に発生した変更を確認できます。

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

次の使用例は、コマンド プロンプト ウィンドウの SolutionA フォルダーに対する最新の変更を表示します。

c:\code\SiteApp\Main\SolutionA>tf history . /noprompt
  • 履歴 ウィンドウの使用方法については、「項目の履歴を取得する」を参照してください。
  • 変更セットの詳細については、「変更セットの検索と表示」を参照してください。
  • また、「過去のバージョンを表示および管理する」も参照してください。