Sdílet prostřednictvím


Příkaz Historie (Správa verzí Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

Příkaz Správa verzí Team Foundation (TFVC) tf history zobrazí historii revizí jednoho nebo více souborů nebo složek. Data příkazu se zobrazí buď v okně Historie v sadě Visual Studio, nebo pokud /noprompt je tato možnost zadána, na příkazovém řádku.

K získání historie revizí můžete také použít Visual Studio. Další informace naleznete v tématu Získání historie položky.

Požadavky

Viz Výchozí oprávnění TFVC.

Syntaxe

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]

Parametry

Parametr

Popis

/collection:<TeamProjectCollectionUrl>

Určuje adresu URL kolekce projektů, která obsahuje položky. Například: http://myserver:8080/tfs/DefaultCollection.

Ve výchozím nastavení se předpokládá, že kolekce projektů je ta, která obsahuje pracovní prostor, který mapuje aktuální adresář.

/format

Určuje, kolik podrobností se má při zadání možnosti zobrazit o jednotlivých sadách změn /noprompt :

  • Brief (výchozí): Zobrazí jeden řádek o každé sadě změn, která zahrnuje: číslo ID, změny provedené, uživatel, který provedl změny, datum a komentář. Některá data mohou být zkrácena.

  • Detailed: Zobrazí úplný popis každé sady změn. Kromě předchozích informací zobrazí tato možnost další data, jako je datum s časem, změněné položky, poznámky k vrácení se změnami a upozornění zásad vrácení se změnami.

/itemmode

Tuto možnost nemůžete kombinovat s /slotmode touto možností. Další informace najdete v tématu Matt Mitrik: Změna režimu slotu v TFS 2010 Správa verzí.

<itemspec>

Určuje položky, pro které se má zobrazit historie. Syntaxi najdete v tématu Použití příkazů správy verzí Team Foundation.

/noprompt

Potlačí zobrazení oken a dialogových oken, jako je okno Historie , a přesměruje výstupní data na příkazový řádek. Viz Použití příkazů správy verzí Team Foundation.

Nezobrazuje historii revizí, ke kterým došlo před přesunutím, přejmenováním, větvení nebo sloučením položky.

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

Určuje uživatelský účet ke spuštění příkazu. Viz Použití příkazů správy verzí Team Foundation.

/recursive

Rekurzivně načte historická data o položkách v zadaném adresáři a všech podadresářích.

/slotmode

Tuto možnost nemůžete kombinovat s /itemmode touto možností. Další informace najdete v tématu Matt Mitrik: Změna režimu slotu v TFS 2010 Správa verzí.

/sort

Seřadí historii revizí pro jeden nebo více souborů nebo složek v některém z následujících pořadí:

  • Ascending: Od nejstarších po nejnovější revizi.

  • Descending (výchozí): Od nejnovějších po nejstarší revizi.

Tuto možnost musíte použít /noprompt s touto možností.

/stopafter:<number>

Určuje maximální počet sad změn, které se mají zobrazit v datech historie.

/user:<username>

Filtruje historická data tak, aby zobrazovala změny provedené zadaným uživatelem. Symbol hvězdičky (*) obsahuje data o změnách ze všech uživatelů, výchozí nastavení.

/version:<versionspec>

Určuje buď maximální verzi, nebo minimální a maximální verzi pomocí syntaxe rozsahu ~ . Výchozí hodnota je /version:Wverze v pracovním prostoru.

Tuto možnost nemůžete kombinovat s /slotmode touto možností.

Syntaxi najdete v tématu Použití příkazů správy verzí Team Foundation.

Poznámky

  • Pokud chcete získat podrobnější informace o sadě změn, například zobrazení přidružených pracovních položek:

    • V okně Historie sady Visual Studio poklikejte nebo klikněte pravým tlačítkem na sadu změn a zvolte Podrobnosti sady změn.

    • Z příkazového řádku použijte příkaz Changeset.

  • Tato /collection možnost je užitečná pro spuštění tohoto příkazu z počítače a uživatelského účtu, který nemá pracovní prostor namapovaný na kolekci projektů, která obsahuje položky.

Příklady

Následující příklady předpokládají, že c:\code\SiteApp\Main mapuje na hlavní složku v pracovním prostoru.

Získání historie jednoho souboru

Následující příklad zobrazí všechny změny provedené v program2.cs v okně Historie .

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

Následující příklad zobrazí všechny změny provedené v program2.cs v okně příkazového řádku.

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

Výstup:

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

Získání historie všech položek ve složce

Následující příklad zobrazí všechny změny provedené ve všech položkách řešení , včetně položek v podsložkách, v okně Historie .

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

Získání historie posledních pěti změn všech položek ve složce

V následujícím příkladu se v okně příkazového řádku zobrazí posledních pět změn položek v řešení A, včetně těch v podsložkách:

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

Výstup:

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

Získání historie z verze x a starší

Následující příklad zobrazí změny všech položek v řešení A, včetně položek v podsložkách, ve verzi 30 a starší, v okně příkazového řádku:

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

Výstup:

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

Získání historie od data D a dřívějšího data

Následující příklady zobrazují změny všech položek v ŘešeníA, včetně položek v podsložkách, ve 23. 4. 23. nebo starším, v okně příkazového řádku:

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

Nebo:

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

Výstup:

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

Získání historie z rozsahu kalendářních dat

Následující příklad zobrazí změny provedené u všech položek v řešení A, včetně položek v podsložkách, mezi 12. 4. 2012 a 4. 23. 2012 v okně příkazového řádku:

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

Výstup:

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 

Získání podrobné historie

Následující příklad zobrazí podrobnosti o změnách provedených ve všech položkách řešení , včetně položek v podsložkách, mezi 4. 12. 2012 a 4. 23. 2012 v okně příkazového řádku:

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

Výstup:

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

Získání nerekurzivní historie složky

Následující příklad zobrazuje historii složky SolutionA v okně Historie sady Visual Studio, které umožňuje prozkoumat dřívější změny složky. Pokud byla například poslední změna složky přejmenována, můžete sadu změn rozbalit a zobrazit změny, ke kterým došlo před přejmenování.

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

Následující příklad zobrazí poslední změnu složky SolutionA v okně příkazového řádku.

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