Delen via

Opdracht Geschiedenis (Team Foundation-versiebeheer)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Met de opdracht Team Foundation Version Control (TFVC) tf history wordt de revisiegeschiedenis van een of meer bestanden of mappen weergegeven. De opdrachtgegevens worden weergegeven in het venster Geschiedenis in Visual Studio of als de optie /noprompt is opgegeven, bij de opdrachtprompt.

U kunt Visual Studio ook gebruiken om de revisiegeschiedenis op te halen. Zie De geschiedenis van een itemophalen voor meer informatie.

Benodigdheden

Zie standaard TFVC-machtigingen.

Syntaxis

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]

Parameterwaarden

parameter

Beschrijving

/collection:<TeamProjectCollectionUrl>

Hiermee geeft u de URL van de projectverzameling die de items bevat. Voorbeeld: http://myserver:8080/tfs/DefaultCollection.

Standaard wordt ervan uitgegaan dat de projectverzameling degene is die de werkruimte bevat die de huidige map toe wijst.

/format

Hiermee geeft u op hoeveel details over elke wijzigingenset moeten worden weergegeven wanneer de optie /noprompt is opgegeven:

  • Brief (standaard): Geeft één regel weer over elke wijzigingenset die het volgende omvat: id-nummer, wijzigingen aangebracht, gebruiker die de wijzigingen, datum en opmerking heeft aangebracht. Sommige gegevens kunnen worden afgekapt.

  • Detailed: geeft een volledige beschrijving weer van elke wijzigingenset. Naast de voorgaande informatie worden met deze optie meer gegevens weergegeven, zoals datum met tijd, gewijzigde items, check-innotities en incheckbeleidswaarschuwingen.

/itemmode

U kunt deze optie niet combineren met de optie /slotmode. Zie Matt Mitrik: Overschakelen naar slotmodus in TFS 2010 Versiebeheervoor meer informatie.

<itemspec>

Hiermee geeft u de items op waarvoor de geschiedenis moet worden weergegeven. Zie Team Foundation-opdrachten voor versiebeheer gebruikenvoor syntaxis.

/noprompt

Onderdrukt de weergave van vensters en dialoogvensters, zoals het venster Geschiedenis, en stuurt uitvoergegevens om naar de opdrachtprompt. Zie Opdrachten voor versiebeheer van Team Foundation gebruiken.

Geeft niet de geschiedenis weer van revisies die plaatsvonden voordat een item werd verplaatst, hernoemd, vertakt of samengevoegd.

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

Hiermee geeft u het gebruikersaccount om de opdracht uit te voeren. Zie Opdrachten voor versiebeheer van Team Foundation gebruiken.

/recursive

Recursief haalt historische gegevens op voor items in de opgegeven map en eventuele submappen.

/slotmode

U kunt deze optie niet combineren met de optie /itemmode. Zie Matt Mitrik: Overschakelen naar slotmodus in TFS 2010 Versiebeheervoor meer informatie.

/sort

Sorteert de revisiegeschiedenis voor een of meer bestanden of mappen in een van de volgende orders:

  • Ascending: van de oudste naar de meest recente revisie.

  • Descending (standaard): Van de meest recente naar de oudste revisie.

U moet de optie /noprompt gebruiken met deze optie.

/stopafter:<number>

Hiermee geeft u het maximum aantal wijzigingensets op dat moet worden weergegeven in de geschiedenisgegevens.

/user:<username>

Hiermee filtert u de historische gegevens om wijzigingen weer te geven die door de opgegeven gebruiker zijn aangebracht. Een sterretje (*) bevat gegevens over wijzigingen van alle gebruikers, de standaardwaarde.

/version:<versionspec>

Hiermee geeft u de maximale versie of de minimum- en maximumversies op met behulp van het bereik ~ syntaxis. De standaardwaarde is /version:W, de versie in de werkruimte.

U kunt deze optie niet combineren met de optie /slotmode.

Zie Team Foundation-opdrachten voor versiebeheer gebruikenvoor syntaxis.

Opmerkingen

  • Voor meer gedetailleerde informatie over een wijzigingenset, bijvoorbeeld om gekoppelde werkitems te bekijken:

    • Dubbelklik of klik in het venster geschiedenis van Visual Studio op de wijzigingenset en kies Details van wijzigingenset.

    • Gebruik vanaf de opdrachtprompt de opdracht Changeset.

  • De optie /collection is handig voor het uitvoeren van deze opdracht vanaf een computer en gebruikersaccount dat geen werkruimte heeft die is toegewezen aan de projectverzameling die de items bevat.

Voorbeelden

In de volgende voorbeelden wordt ervan uitgegaan dat c:\code\SiteApp\Main wordt toegewezen aan de hoofdmap in de werkruimte.

Geschiedenis van één bestand ophalen

In het volgende voorbeeld worden alle wijzigingen weergegeven die zijn aangebracht in program2.cs in het venster Geschiedenis.

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

In het volgende voorbeeld worden alle wijzigingen weergegeven die zijn aangebracht in program2.cs in het opdrachtpromptvenster.

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

Uitvoer:

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

Geschiedenis van alle items in een map ophalen

In het volgende voorbeeld worden alle wijzigingen weergegeven die zijn aangebracht in alle items in SolutionA-, inclusief die in submappen, in het venster Geschiedenis.

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

Geschiedenis ophalen van de laatste vijf wijzigingen in alle items in een map

In het volgende voorbeeld worden de meest recente vijf wijzigingen weergegeven die zijn aangebracht in items in SolutionA-, inclusief de wijzigingen in submappen, in het opdrachtpromptvenster:

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

Uitvoer:

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

Geschiedenis ophalen van versie x en eerder

In het volgende voorbeeld worden wijzigingen weergegeven die zijn aangebracht in alle items in SolutionA-, inclusief items in submappen, in versie 30 en eerder, in het opdrachtpromptvenster:

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

Uitvoer:

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

Geschiedenis ophalen van datum D en eerder

In de volgende voorbeelden worden wijzigingen weergegeven die zijn aangebracht in alle items in SolutionA-, inclusief items in submappen, op 4-23-12 of eerder, in het opdrachtpromptvenster:

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

Of:

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

Uitvoer:

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

Geschiedenis ophalen uit een reeks datums

In het volgende voorbeeld worden wijzigingen weergegeven die zijn aangebracht in alle items in SolutionA-, inclusief de items in submappen, tussen 12-12-2012 en 23-4-2012, in het opdrachtpromptvenster:

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

Uitvoer:

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

Gedetailleerde geschiedenis ophalen

In het volgende voorbeeld ziet u details over wijzigingen die zijn aangebracht in alle items in SolutionA-, inclusief de wijzigingen in submappen, tussen 12-12-2012 en 23-4-2012, in het opdrachtpromptvenster:

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

Uitvoer:

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

De niet-recursieve geschiedenis van een map ophalen

In het volgende voorbeeld ziet u de geschiedenis van de map SolutionA in het venster Visual Studio History, waarmee u eerdere wijzigingen in de map kunt verkennen. Als de meest recente wijziging in de map bijvoorbeeld een nieuwe naam heeft, kunt u de wijzigingenset uitvouwen om wijzigingen te zien die zijn opgetreden vóór de naam van de map.

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

In het volgende voorbeeld ziet u de meest recente wijziging in de map SolutionA in het opdrachtpromptvenster.

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