History-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Mit dem tf history-Befehl der Team Foundation-Versionskontrolle (TFVC) wird der Revisionsverlauf mindestens einer Datei oder eines Ordners angezeigt. Die Befehlsdaten werden entweder im Fenster Verlauf in Visual Studio oder, wenn die Option /noprompt angegeben wird, in der Eingabeaufforderung angezeigt.

Sie können auch Visual Studio verwenden, um den Revisionsverlauf abzurufen. Weitere Informationen finden Sie unter Abrufen des Verlaufs eines Elements.

Voraussetzungen

Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

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]

Parameter

Parameter

Beschreibung

/collection:<TeamProjectCollectionUrl>

Gibt die URL der Projektsammlung an, in der die Elemente enthalten sind. Beispiel: http://myserver:8080/tfs/DefaultCollection.

Standardmäßig wird davon ausgegangen, dass die Projektsammlung den Arbeitsbereich enthält, der dem aktuellen Verzeichnis zugeordnet ist.

/format

Gibt an, wie viele Details zu jedem Changeset angezeigt werden, wenn die /noprompt-Option angegeben wird:

  • Brief (Standard): Zeigt eine Zeile pro Changeset an, die die folgenden Informationen enthält: ID-Nummer, vorgenommene Änderungen, Benutzer, der die Änderungen vorgenommen hat, Datum und Kommentar. Einige der Daten werden möglicherweise abgeschnitten.

  • Detailed: Zeigt eine vollständige Beschreibung für jedes Changeset an. Neben den oben genannten Informationen werden mit dieser Option weitere Daten angezeigt, z. B. Datum mit Uhrzeit, geänderte Elemente, Eincheckhinweise und Eincheckrichtlinienwarnungen.

/itemmode

Sie können diese Option nicht mit der Option /slotmode kombinieren. Weitere Informationen finden Sie in Matt Mitriks-Artikel zur Änderung des Slotmodus in der TFS 2010-Versionskontrolle.

<itemspec>

Gibt an, für welche Elemente der Verlauf angezeigt wird. Weitere Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/noprompt

Unterdrückt die Anzeige von Fenstern und Dialogfeldern (wie z. B. des Fensters Verlauf) und leitet Ausgabedaten an die Eingabeaufforderung um. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Zeigt keinen Verlauf für Änderungen an, die aufgetreten sind, bevor ein Element verschoben, umbenannt, gebrancht oder gemergt wurde.

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

Gibt das Benutzerkonto an, unter dem der Befehl ausgeführt wird. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/recursive

Ruft rekursiv Verlaufsdaten zu Elementen im angegebenen Verzeichnis und in sämtlichen Unterverzeichnissen ab.

/slotmode

Sie können diese Option nicht mit der /itemmode-Option kombinieren. Weitere Informationen finden Sie in Matt Mitriks-Artikel zur Änderung des Slotmodus in der TFS 2010-Versionskontrolle.

/sort

Sortiert den Revisionsverlauf für eine oder mehrere Dateien oder Ordner in einer der beiden folgenden Reihenfolgen:

  • Ascending: von der ältesten zur neuesten Revision.

  • Descending (Standard): von der neuesten zur ältesten Revision.

Mit dieser Option muss die /noprompt-Option verwendet werden.

/stopafter:<number>

Gibt die maximale Anzahl der Changesets an, die in den Verlaufsdaten angezeigt werden.

/user:<username>

Filtert die Verlaufsdaten, um die Änderungen anzuzeigen, die vom angegebenen Benutzer vorgenommen werden. Mit einem Sternchensymbol (*) werden Daten zu Änderungen von allen Benutzern einbezogen (Standard).

/version:<versionspec>

Gibt mithilfe der Bereichssyntax ~ entweder die Höchstversion oder die Mindest- und Höchstversion an. Der Standardwert ist /version:W (die Version im Arbeitsbereich).

Sie können diese Option nicht mit der Option /slotmode kombinieren.

Weitere Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Bemerkungen

  • Weitere Informationen zu einem Changeset (z. B. die zugeordneten Arbeitselemente) erhalten Sie folgendermaßen:

    • Doppelklicken Sie im Fenster Verlauf von Visual Studio auf das Changeset, oder klicken Sie mit der rechten Maustaste darauf, und wählen Sie dann Changesetdetails aus.

    • Verwenden Sie in der Eingabeaufforderung den Changeset-Befehl.

  • Die /collection-Option ist nützlich, wenn Sie diesen Befehl von einem Computer und einem Benutzerkonto ausführen möchten, die nicht über einen Arbeitsbereich mit Zuordnung zu der Projektsammlung verfügen, in der die Elemente enthalten sind.

Beispiele

In den folgenden Beispielen wird davon ausgegangen, dass c:\code\SiteApp\Main dem Ordner „main“ im Arbeitsbereich zugeordnet ist.

Abrufen des Verlaufs einer einzelnen Datei

Im folgenden Beispiel werden alle Änderungen an program2.cs im Fenster Verlauf angezeigt.

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

Im folgenden Beispiel werden alle Änderungen an program2.cs im Eingabeaufforderungsfenster angezeigt.

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

Ausgabe:

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

Abrufen des Verlaufs aller Elemente in einem Ordner

Im folgenden Beispiel werden alle Änderungen im Fenster Verlauf angezeigt, die an allen Elementen in SolutionA vorgenommen wurden (einschließlich der Änderungen in Unterordnern).

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

Abrufen des Verlaufs der letzten fünf Änderungen aller Elemente in einem Ordner

Im folgenden Beispiel werden die letzten fünf Änderungen an Elementen in SolutionA (einschließlich Änderungen in Unterordnern) im Eingabeaufforderungsfenster angezeigt:

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

Ausgabe:

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

Abrufen des Verlaufs aus Version x und früher

Das folgende Beispiel zeigt die Änderungen an allen Elementen in SolutionA (einschließlich Änderungen in Unterordnern) in Version 30 und früher im Eingabeaufforderungsfenster an:

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

Ausgabe:

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

Abrufen des Verlaufs ab Datum D und früher

Die folgenden Beispiele zeigen die Änderungen an allen Elementen in SolutionA (einschließlich Änderungen in Unterordnern) am 23.04.12 oder früher im Eingabeaufforderungsfenster an:

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

Oder:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D2012-04-24T12:00

Ausgabe:

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

Abrufen des Verlaufs aus einem Datumsbereich

Das folgende Beispiel zeigt die Änderungen an allen Elementen in SolutionA (einschließlich Änderungen in Unterordnern) zwischen dem 12.04.2012 und dem 23.04.2012 im Eingabeaufforderungsfenster an:

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

Ausgabe:

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

Abrufen eines detaillierten Verlaufs

Das folgende Beispiel zeigt Details zu Änderungen an allen Elementen in SolutionA (einschließlich Änderungen in Unterordnern) zwischen dem 12.04.2012 und dem 23.04.2012 im Eingabeaufforderungsfenster an:

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

Ausgabe:

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

Abrufen des nicht rekursiven Verlaufs eines Ordners

Im folgenden Beispiel wird der Verlauf des Ordners SolutionA im Fenster Verlauf von Visual Studio angezeigt, sodass Sie frühere Änderungen am Ordner untersuchen können. Wenn z. B. die letzte Änderung am Ordner eine Umbenennung war, können Sie das Changeset erweitern, um Änderungen anzuzeigen, die vor der Umbenennung vorgenommen wurden.

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

Das folgende Beispiel zeigt die letzte Änderung am Ordner SolutionA im Eingabeaufforderungsfenster an.

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