Rollback コマンド (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 rollback コマンドを使用して、1 つ以上のバージョン管理された項目に対する 1 つ以上の変更セットの影響をロールバックできます。 このコマンドは、アイテムのバージョン履歴から変更セットを削除しません。 代わりに、このコマンドは、指定した変更セットの効果を否定する保留中の変更のセットをワークスペースに作成します。

前提 条件

このコマンドを使用するには、読み取り、チェックアウト、およびチェックイン アクセス許可 [を許可] に設定します。 詳細については、「既定の TFVC アクセス許可 」を参照してください。

構文

tf rollback /toversion:VersionSpec ItemSpec [/recursive] [/lock:none|checkin|checkout] [/version:versionspec] [/keepmergehistory] [/login:username,[password]] [/noprompt]

tf rollback /changeset:ChangesetFrom~ChangesetTo [ItemSpec] [/recursive] [/lock:none|checkin|checkout] [/version:VersionSpec]
[/keepmergehistory] [/noprompt] [/login:username,[password]]

パラメーター

引数

オプション

備考

tf rollback コマンドは、指定した各項目に対して指定した各変更セットの効果を否定します。 次の表に、操作が各種類の変更を否定する方法を示します。

次の一覧に、rollback コマンドの結果の変更の例をいくつか示します。

• 追加 変更が発生した変更セットをロールバックします。 ロールバック操作により、ロールバック 変更が発生し、削除 変更が発生します。

• 編集 変更が発生した変更セット 521 をロールバックします。 ロールバック操作により、ロールバック 変更が発生し、編集 変更が発生し、変更セット 521 で 編集 変更が無効になります。

• changeset 132 では、$/BranchA/File1.txt から $/BranchB/File1.txtにマージしました。 そのマージの変更には、変更セット 92 と 104 の変更 編集 含まれています。 変更セット 162 では、変更セット 132 をロールバックすると、ロールバック 変更が発生し、変更セット 92 および 104 の 編集 変更を無効にする $/BranchB/File1.txt に 編集 変更が行われます。

終了コード

tf rollback コマンドを実行すると、次の表の終了コードが表示されます。

例

次の例では、その変更セットで変更されたすべての項目に対する変更セット 23 の効果を否定します。

c:\workspace> tf rollback /changeset:C23

次の例では、ファイル a.txtに対する changeset 23 の効果を否定します。

c:\workspace> tf rollback /changeset:C23 a.txt

次の例では、変更セット 23 でチェックインされたバージョンと一致するように a.txt の内容を変更します。

c:\workspace> tf rollback /toversion:C23 a.txt

次の例では、OurTeamProject の内容を、2009 年 8 月 31 日午前 0 時以前に適用された最後の変更セットと一致するように変更します。

c:\workspace> tf rollback /toversion:D08/31/2009 /recursive $/OurTeamProject/

/keepmergehistory オプションの例

ブランチまたはマージの変更を含む変更セットをロールバックする場合、通常は、同じソースと同じターゲットの間で将来のマージを行って、それらの変更を含める必要があります。 ただし、同じソースと同じターゲットの間で今後マージを行い、過去のマージ操作に含まれる変更セットを除外する場合は、/keepmergehistory オプションを使用できます。 例えば：

1. 2009 年 6 月 30 日に、$/BranchA/ から $/BranchB/へのすべてのアイテムの完全なマージを実行します。

   c:\workspace> tf merge $/BranchA $/BranchB
   

   このマージは、変更セット 292 の一部としてチェックインします。

2. 7 月には、$/BranchA/Util.csいくつかの変更を行います。 これらの変更は、変更セット 297、301、および 305 に含まれます。

3. 2009 年 8 月 1 日に、$/BranchA/Util.cs を $/BranchB/Util.csにマージします。

   c:\workspace> tf merge $/BranchA/Util.cs $/BranchB/Util.cs
   

   変更セット 314 の一部として変更をチェックインします。 この操作の結果、変更セット 297、301、および 305 で $/BranchA/Util.cs に加えた編集が、$/BranchB/Util.csにも適用されるようになりました。

4. 1 週間後、7 月に $/BranchA/Util.cs を するために行った編集は、$/BranchB/Util.csには適していません。 rollback コマンドを使用して、これらの変更を否定できます。 rollback コマンドを使用して、マージ 変更または ブランチ 変更をロールバックする場合は、決定する必要があります。

   • 7 月に $/BranchA/Util.cs に加えた変更を、今後のマージで $/BranchB/Util.cs に再適用する場合は、次のコマンドを入力します。

     c:\workspace> tf rollback /changeset:314
     

   • 7 月に $/BranchA/Util.cs に加えた変更を今後のマージで $/BranchB/Util.cs に再適用しない場合は、次のコマンドを入力します。

     c:\workspace> tf rollback /changeset:314 /keepmergehistory
     

5. 数週間後、$/BranchA/ $/BranchB/にマージします。

   c:\workspace> tf merge $/BranchA $/BranchB
   

   • ロールバック時に /keepmergehistory オプションを省略した場合、変更セット 297、301、305 を含む、変更セット 292 以降 $/BranchA/Util.cs に適用されたすべての変更セット $/BranchB/Util.cs に、マージ 変更が適用されます。 つまり、マージによってロールバックの変更が元に戻されます。

   • ロールバック時に /keepmergehistory オプションを含めた場合、マージ操作は、変更セット 292 以降、変更セット 297、301、および 305 を除く、$/BranchA/Util.cs に適用されたすべての変更セット $/BranchB/Util.cs に適用されます。 つまり、マージはロールバックの変更を元に戻しません。 したがって、BranchA のコンテンツが、BranchBのコンテンツと一致しない可能性があります。

関連記事

• Team Foundation バージョン管理コマンドを使用する
• Merge コマンド