Freigeben über


Befehl "Verlauf" (Team Foundation-Versionssteuerung)

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

Visual Studio 2019 | Visual Studio 2022

Der Befehl "Team Foundation Version Control" (TFVC) tf history zeigt den Überarbeitungsverlauf einer oder mehrerer Dateien oder Ordner an. Die Befehlsdaten werden entweder im Fenster Verlauf in Visual Studio angezeigt oder wenn die option /noprompt angegeben ist, an der Eingabeaufforderung.

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

Voraussetzungen

Siehe Standard-TFVC-Berechtigungen.

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]

Die Parameter

Parameter

Beschreibung

/collection:<TeamProjectCollectionUrl>

Gibt die URL der Projektauflistung an, die die Elemente enthält. Beispiel: http://myserver:8080/tfs/DefaultCollection.

Standardmäßig wird davon ausgegangen, dass die Projektsammlung der Arbeitsbereich ist, der das aktuelle Verzeichnis zuordnet.

/format

Gibt an, wie viele Details zu den einzelnen Änderungen angezeigt werden sollen, wenn die Option /noprompt angegeben wird:

  • Brief (Standard): Zeigt eine Zeile zu den einzelnen Änderungen an, die Folgendes umfassen: ID-Nummer, vorgenommene Änderungen, Benutzer, die die Änderungen, das Datum und den Kommentar vorgenommen haben. Einige der Daten werden möglicherweise abgeschnitten.

  • Detailed: Zeigt eine vollständige Beschreibung der einzelnen Änderungen an. Zusätzlich zu den vorherigen Informationen zeigt diese Option weitere Daten an, z. B. Datum mit Uhrzeit, Geänderte Elemente, Einchecken von Notizen und Eincheckrichtlinienwarnungen.

/itemmode

Sie können diese Option nicht mit der Option /slotmode kombinieren. Weitere Informationen finden Sie unter Matt Mitrik: Wechsel zum Slotmodus in TFS 2010 Version Control.

<itemspec>

Gibt die Elemente an, für die der Verlauf angezeigt werden soll. Syntax finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

/noprompt

Unterdrückt die Anzeige von Fenstern und Dialogfeldern, z. B. das fenster Verlauf, und leitet Ausgabedaten an die Eingabeaufforderung um. Siehe Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

Zeigt nicht den Verlauf der Überarbeitungen an, die vor dem Verschieben, Umbenennen, Verzweigen oder Zusammenführen eines Elements aufgetreten sind.

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

Gibt das Benutzerkonto an, mit dem der Befehl ausgeführt werden soll. Siehe Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

/recursive

Ruft rekursiv historische Daten zu Elementen im angegebenen Verzeichnis und allen Unterverzeichnissen ab.

/slotmode

Sie können diese Option nicht mit der Option /itemmode kombinieren. Weitere Informationen finden Sie unter Matt Mitrik: Wechsel zum Slotmodus in TFS 2010 Version Control.

/sort

Sortiert den Überarbeitungsverlauf für eine oder mehrere Dateien oder Ordner in einer der folgenden Bestellungen:

  • Ascending: Von der ältesten bis zur letzten Überarbeitung.

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

Sie müssen die Option /noprompt mit dieser Option verwenden.

/stopafter:<number>

Gibt die maximale Anzahl von Änderungen an, die in den Verlaufsdaten angezeigt werden sollen.

/user:<username>

Filtert die Verlaufsdaten, um änderungen anzuzeigen, die vom angegebenen Benutzer vorgenommen wurden. Ein Sternchen (*) enthält Daten zu Änderungen von allen Benutzern, der Standard.

/version:<versionspec>

Gibt entweder die maximale Version oder die minimale und maximale Version mithilfe des Bereichs ~ Syntax an. Der Standardwert ist /version:W, der Version im Arbeitsbereich.

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

Syntax finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

Bemerkungen

  • Um detailliertere Informationen zu einem Changeset zu erhalten, z. B. um zugeordnete Arbeitsaufgaben anzuzeigen:

    • Doppelklicken oder klicken Sie im Fenster Verlauf Visual Studio mit der rechten Maustaste auf das Änderungsset, und wählen Sie Changeset-Detailsaus.

    • Verwenden Sie an der Eingabeaufforderung den Befehl Changeset.

  • Die option /collection ist nützlich, um diesen Befehl von einem Computer und Benutzerkonto aus auszuführen, der nicht über einen Arbeitsbereich verfügt, der der Projektsammlung zugeordnet ist, die die Elemente enthält.

Beispiele

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

Abrufen des Verlaufs einer einzelnen Datei

Im folgenden Beispiel werden alle An program2.cs vorgenommenen Änderungen im fenster Verlauf angezeigt.

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

Im folgenden Beispiel werden alle An program2.cs vorgenommenen Änderungen 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 angezeigt, die an allen Elementen in SolutionA-vorgenommen wurden, einschließlich der Änderungen in Unterordnern im Fenster Verlauf.

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

Abrufen des Verlaufs der letzten fünf Änderungen an allen Elementen in einem Ordner

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

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 von Version x und früher

Im folgenden Beispiel werden Änderungen an allen Elementen in SolutionA-angezeigt, einschließlich der Elemente in Unterordnern, in Version 30 und früher, im Eingabeaufforderungsfenster:

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 von Datum D und früher

In den folgenden Beispielen werden Änderungen angezeigt, die an allen Elementen in SolutionAvorgenommen wurden, einschließlich derJenigen in Unterordnern, am 23.04.12 oder früher im Eingabeaufforderungsfenster:

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

Im folgenden Beispiel werden Änderungen an allen Elementen in SolutionA-angezeigt, einschließlich der Elemente in Unterordnern, zwischen dem 12.04.2012 und dem 23.04.2012 im Eingabeaufforderungsfenster:

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 

Detaillierter Verlauf abrufen

Im folgenden Beispiel werden Details zu änderungen angezeigt, die an allen Elementen in SolutionAvorgenommen wurden, einschließlich derJenigen in Unterordnern, zwischen dem 12.04.2012 und dem 23.04.2012 im Eingabeaufforderungsfenster:

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 "Visual Studio Verlauf" angezeigt, in dem Sie frühere Änderungen am Ordner untersuchen können. Wenn beispielsweise die letzte Änderung des Ordners eine Umbenennung war, können Sie das Änderungsset erweitern, um vor der Umbenennung vorgenommene Änderungen anzuzeigen.

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

Im folgenden Beispiel wird die letzte Änderung des SolutionA- Ordners im Eingabeaufforderungsfenster angezeigt.

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