Historikkommando (Versionskontroll för Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Kommandot Team Foundation Version Control (TFVC) tf history visar revisionshistoriken för en eller flera filer eller mappar. Kommandodata visas antingen i fönstret Historik i Visual Studio eller om /noprompt alternativet anges i kommandotolken.

Du kan också använda Visual Studio för att hämta revisionshistorik. Mer information finns i Hämta historiken för ett objekt.

Förutsättningar

Se TFVC-standardbehörigheter.

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]

Parametrar

Parameter

Beskrivning

/collection:<TeamProjectCollectionUrl>

Anger URL:en för den projektsamling som innehåller objekten. Exempel: http://myserver:8080/tfs/DefaultCollection.

Som standard antas projektsamlingen vara den som innehåller arbetsytan som mappar den aktuella katalogen.

/format

Anger hur mycket information som ska visas om varje ändringsuppsättning när alternativet /noprompt anges:

  • Brief (standard): Visar en rad om varje ändringsuppsättning som innehåller: ID-nummer, gjorda ändringar, användare som gjorde ändringarna, datumet och kommentaren. Vissa data kan trunkeras.

  • Detailed: Visar en fullständig beskrivning av varje ändringsuppsättning. Förutom föregående information visar det här alternativet mer data, till exempel datum med tid, ändrade objekt, incheckningsanteckningar och incheckningsprincipvarningar.

/itemmode

Du kan inte kombinera det här alternativet med alternativet /slotmode . Mer information finns i Matt Mitrik: Changing to Slot Mode in TFS 2010 Version Control (Matt Mitrik: Changing to Slot Mode in TFS 2010 Version Control).

<itemspec>

Anger de objekt som historiken ska visas för. Syntax finns i Använda Team Foundation-versionskontrollkommandon.

/noprompt

Undertrycker visning av fönster och dialogrutor, till exempel fönstret Historik , och omdirigerar utdata till kommandotolken. Mer information finns i Använda kommandon för versionskontroll i Team Foundation.

Visar inte historiken för revisioner som inträffade innan ett objekt flyttades, bytte namn, förgrenades eller sammanfogades.

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

Anger vilket användarkonto som ska köra kommandot. Mer information finns i Använda kommandon för versionskontroll i Team Foundation.

/recursive

Rekursivt hämtar historiska data på objekt i den angivna katalogen och eventuella underkataloger.

/slotmode

Du kan inte kombinera det här alternativet med alternativet /itemmode . Mer information finns i Matt Mitrik: Changing to Slot Mode in TFS 2010 Version Control (Matt Mitrik: Changing to Slot Mode in TFS 2010 Version Control).

/sort

Sorterar revisionshistoriken för en eller flera filer eller mappar i någon av följande beställningar:

  • Ascending: Från den äldsta till den senaste revisionen.

  • Descending (standard): Från den senaste till den äldsta revisionen.

Du måste använda alternativet /noprompt med det här alternativet.

/stopafter:<number>

Anger det maximala antalet ändringsuppsättningar som ska visas i historikdata.

/user:<username>

Filtrerar historiska data för att visa ändringar som gjorts av den angivna användaren. En asterisksymbol (*) innehåller data om ändringar från alla användare, standardvärdet.

/version:<versionspec>

Anger antingen den maximala versionen eller de lägsta och högsta versionerna med hjälp av intervallsyntaxen ~ . Standardvärdet är /version:W, versionen på arbetsytan.

Du kan inte kombinera det här alternativet med alternativet /slotmode .

Syntax finns i Använda Team Foundation-versionskontrollkommandon.

Kommentarer

  • För att få mer detaljerad information om en ändringsuppsättning, till exempel för att se associerade arbetsobjekt:

    • I fönstret Visual Studio-historik dubbelklickar eller högerklickar du på ändringsuppsättningen och väljer Information om ändringsuppsättning.

    • Använd kommandot Changeset i kommandotolken.

  • Alternativet /collection är användbart för att köra det här kommandot från en dator och ett användarkonto som inte har en arbetsyta mappad till projektsamlingen som innehåller objekten.

Exempel

I följande exempel förutsätts att c:\code\SiteApp\Main mappar till huvudmappen på arbetsytan.

Hämta historik för en enskild fil

I följande exempel visas alla ändringar som gjorts i program2.cs i fönstret Historik .

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

I följande exempel visas alla ändringar som gjorts i program2.cs i kommandotolkens fönster.

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

Utdata:

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

Hämta historik för alla objekt i en mapp

I följande exempel visas alla ändringar som gjorts i alla objekt i SolutionA, inklusive de i undermappar, i fönstret Historik .

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

Hämta historik över de fem senaste ändringarna av alla objekt i en mapp

I följande exempel visas de fem senaste ändringarna av objekt i SolutionA, inklusive de i undermappar, i kommandotolkens fönster:

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

Utdata:

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

Hämta historik från version x och tidigare

I följande exempel visas ändringar som gjorts i alla objekt i SolutionA, inklusive de i undermappar, i version 30 och tidigare, i kommandotolkens fönster:

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

Utdata:

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

Hämta historik från datum D och tidigare

I följande exempel visas ändringar som gjorts i alla objekt i SolutionA, inklusive de i undermappar, den 23/12 eller tidigare i kommandotolkens fönster:

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

Eller:

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

Utdata:

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

Hämta historik från ett antal datum

I följande exempel visas ändringar som gjorts i alla objekt i SolutionA, inklusive de i undermappar, mellan 2012-04-12 och 2012-04-23 i kommandotolkens fönster:

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

Utdata:

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

Hämta detaljerad historik

I följande exempel visas information om ändringar som gjorts i alla objekt i SolutionA, inklusive de i undermappar, mellan 2012-04-12 och 2012-04-23 i kommandotolkens fönster:

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

Utdata:

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

Hämta den icke-rekursiva historiken för en mapp

I följande exempel visas historiken för SolutionA-mappen i fönstret Visual Studio-historik, som gör att du kan utforska tidigare ändringar i mappen. Om den senaste ändringen av mappen till exempel var ett namnbyte kan du expandera ändringsuppsättningen för att se ändringar som inträffade före namnbytet.

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

I följande exempel visas den senaste ändringen av mappen SolutionA i kommandotolkens fönster.

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