Rollbackbefehl (Team Foundation Version Control)

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022-

Sie können den Befehl "Team Foundation Version Control(TFVC)" tf rollback verwenden, um die Auswirkungen einer oder mehrerer Änderungenets auf ein oder mehrere versionsgesteuerte Elemente zurückzurufen. Mit diesem Befehl werden die Changesets nicht aus dem Versionsverlauf eines Elements entfernt. Stattdessen erstellt dieser Befehl eine Reihe ausstehender Änderungen in Ihrem Arbeitsbereich, die die Auswirkungen der von Ihnen angegebenen Änderungen aufheben.

Voraussetzungen

Wenn Sie diesen Befehl verwenden möchten, müssen Sie die berechtigungen "Lesen", auschecken und Berechtigungen " Einchecken" auf "zulassen" festlegen. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

Syntax

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]]

Parameter

Argumente

Optionen

Bemerkungen

Mit dem Befehl tf rollback wird die Auswirkung der einzelnen Von Ihnen angegebenen Änderungen für jedes von Ihnen angegebene Element aufgehoben. In der folgenden Tabelle wird aufgeführt, wie der Vorgang jede Art von Änderung negiert.

Die folgende Liste enthält einige Beispiele für Änderungen, die aus dem Befehl rollback resultieren:

• Sie führen ein Rollback eines Änderungssets durch, in dem ein Änderung hinzugefügt wurde. Durch den Rollbackvorgang wird ein Rollback und eine Änderung gelöscht.

• Sie führen ein Rollback von Changeset 521 durch, in dem eine Bearbeitung Änderung aufgetreten ist. Durch den Rollbackvorgang wird ein Rollback Änderung und eine änderung Bearbeitung bewirkt, die die Bearbeitung Änderung in Changeet 521 negiert.

• In Changeset 132 haben Sie von $/BranchA/File1.txt zu $/BranchB/File1.txtzusammengeführt. Die Änderungen in dieser Zusammenführung enthalten Änderungen Änderungen in den Änderungssätzen 92 und 104 bearbeiten. In Changeset 162 führen Sie ein Rollback von Changeset 132 durch, das zu einer Rollback- Änderung und einer Änderung Änderung in $/BranchB/File1.txt führt, die die Bearbeitung Änderungen in Änderungssätzen 92 und 104 abhebt.

Ausgangscodes

Nach dem Ausführen des Befehls tf rollback wird ein Exitcode aus der folgenden Tabelle angezeigt.

Beispiele

Im folgenden Beispiel wird die Auswirkung von Changeset 23 auf alle Elemente, die in diesem Changeet geändert wurden, aufgehoben:

c:\workspace> tf rollback /changeset:C23

Im folgenden Beispiel wird die Auswirkung von Changeset 23 auf die Datei a.txtaufgehoben:

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

Im folgenden Beispiel wird der Inhalt a.txt so geändert, dass er mit der Version übereinstimmt, die mit Changeset 23 eingecheckt wurde:

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

Im folgenden Beispiel wird der Inhalt von OurTeamProject- so geändert, dass es mit dem letzten Änderungssatz übereinstimmt, der am 31. August 2009 angewendet wurde oder bevor Mitternacht angewendet wurde:

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

Beispieloption /keepmergehistory

Wenn Sie ein Rollback für ein Changeet ausführen, das eine Verzweigung oder eine Zusammenführungsänderung enthält, möchten Sie in der Regel, dass zukünftige Zusammenführungen zwischen derselben Quelle und demselben Ziel zusammengeführt werden, um diese Änderungen einzuschließen. Sie können jedoch die Option /keepmergehistory verwenden, wenn Sie zukünftige Zusammenführungen zwischen derselben Quelle und demselben Ziel verwenden möchten, um Änderungenets auszuschließen, die in einem früheren Zusammenführungsvorgang enthalten waren. Zum Beispiel:

1. Am 30. Juni 2009 führen Sie eine vollständige Zusammenführung aller Elemente von $/BranchA/ zu $/BranchB/.

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

   Sie überprüfen diesen Seriendruck als Teil von Changeset 292.

2. Im Juli nehmen Sie mehrere Änderungen $/BranchA/Util.csvor. Diese Änderungen sind in den Änderungssätzen 297, 301 und 305 enthalten.

3. Am 1. August 2009 führen Sie $/BranchA/Util.cs mit $/BranchB/Util.cszusammen.

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

   Sie überprüfen die Änderung im Rahmen von Changeset 314. Das Ergebnis dieses Vorgangs ist, dass die Bearbeitungen, die Sie in den Änderungenets 297, 301 und 305 an $/BranchA/Util.cs vorgenommen haben, jetzt auch auf $/BranchB/Util.csangewendet werden.

4. Eine Woche später stellen Sie fest, dass die Bearbeitungen, die Sie an $/BranchA/Util.cs im Juli vorgenommen haben, nicht für $/BranchB/Util.csgeeignet sind. Sie können den Befehl rollback verwenden, um diese Änderungen zu verwerfen. Wenn Sie den Befehl rollback verwenden, um ein Rollback eines Zusammenführens Ändern oder einer Verzweigung Änderung vorzunehmen, haben Sie eine Entscheidung.

   • Wenn Sie möchten, dass die Änderungen, die Sie an $/BranchA/Util.cs vorgenommen haben, im Juli erneut auf $/BranchB/Util.cs in zukünftigen Zusammenführungen angewendet werden sollen, geben Sie den folgenden Befehl ein:

     c:\workspace> tf rollback /changeset:314
     

   • Wenn Sie möchten, dass die Änderungen, die Sie an $/BranchA/Util.cs im Juli vorgenommen haben, nie erneut auf $/BranchB/Util.cs in zukünftigen Zusammenführungen angewendet werden sollen, geben Sie den folgenden Befehl ein:

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

5. Einige Wochen später führen Sie $/BranchA/ in $/BranchB/zusammen.

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

   • Wenn Sie die Option /keepmergehistory beim Zurücksetzen nicht angegeben haben, gilt die Zusammenführung Änderung für $/BranchB/Util.cs alle Änderungenets, die auf $/BranchA/Util.cs seit Changeset 292 angewendet wurden, einschließlich Änderungenets 297, 301 und 305. Mit anderen Worten: Durch den Seriendruck wird die Rollbackänderung rückgängig.

   • Wenn Sie die Option "/keepmergehistory" beim Zurücksetzen hinzugefügt haben, gilt der Zusammenführungsvorgang für $/BranchB/Util.cs alle Änderungenets, die auf $/BranchA/Util.cs seit Changeset 292 angewendet wurden, mit Ausnahme von Changesets 297, 301 und 305. Mit anderen Worten, die Zusammenführung macht die Rollbackänderung nicht rückgängig. Daher entspricht der Inhalt von BranchA- möglicherweise nicht dem Inhalt von BranchB-.

Verwandte Artikel

• Verwenden von Steuerelementbefehlen für die Team Foundation-Version
• Befehl 'Zusammenführen'