Udostępnij za pośrednictwem


Polecenie History

Wyświetla historię poprawek jednego lub więcej plików lub folderów.Dane są wyświetlane w oknie historii, lub jeśli określona jest opcja /noprompt, w wierszu polecenia.

Wymagania: Zobacz Uprawnienia serwera programu Team Foundation Server.

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

Opis

/collection: TeamProjectCollectionUrl

Określa adres URL kolekcji projektu zespołowego zawierającego te elementy.Na przykład http://myserver:8080/tfs/DefaultCollection.

Domyślnie kolekcja projektów zespołu jest uznawana za tę, która zawiera obszar roboczy, który mapuje bieżącego katalogu.

/format

Określa, jak wiele szczegółów na temat każdego zestawu zmian należy wyświetlić w przypadku określenia opcji /noprompt:

  • Brief(ustawienie domyślne): Wyświetla jeden wiersz dla każdego zestawu zmian, który zawiera: numer identyfikacyjny, zmiany dokonane, użytkownika, który wprowadził zmiany, datę i komentarz.Niektóre dane mogą być obcinane.

  • Detailed: Wyświetla pełny opis każdego zestawu zmian.Oprócz powyższych informacji ta opcja wyświetla dodatkowe dane, takie jak data z godziną, elementy zmienione, uwagi ewidencjonowania i ostrzeżenia dotyczące zasad ewidencjonowania.

/itemmode

Tej opcji nie można używać z opcją /slotmode.Zobacz Matt Mitrik: Zmiana na tryb gniazdo w kontroli wersji TFS 2010.

itemspec

Określa elementy, dla których należy wyświetlić historię.Aby uzyskać składnię, zobacz Odniesienie do polecenia kontroli wersji programu Team Foundation.

/noprompt

Ta opcja:

  • Pomija wyświetlanie okien i okien dialogowych (takich jak okno Historia) i przekierowuje dane wyjściowe do wiersza polecenia.Zobacz Odniesienie do polecenia kontroli wersji programu Team Foundation.

  • Nie wyświetla historii zmian, które miały miejsce, zanim element został przeniesiony, zmieniono jego nazwę, został rozgałęziony lub scalony.

/login:username,[password]

Określa konto użytkownika na którym ma zostać uruchomione polecenie.Zobacz Odniesienie do polecenia kontroli wersji programu Team Foundation.

/recursive

Rekursywnie pobiera dane historyczne dotyczące elementów w określonym katalogu i wszystkich podkatalogach.

/slotmode

Tej opcji nie można używać z opcją /itemmode.Zobacz Matt Mitrik: Zmiana na tryb gniazdo w kontroli wersji TFS 2010.

/sort

Sortuje historię poprawek dla jednego lub kilku plików lub folderów w dowolnym z następujących zamówień:

  • Ascending: od najstarszych poprawek do najnowszych.

  • Descending (ustawienie domyślne): od najnowszych poprawek do najstarszych.

Musisz użyć opcji /noprompt z tą opcją.

/stopafter:number

Określa maksymalną liczbę zestawów zmian do wyświetlenia w danych historii.

/user:username

Filtruje dane historyczne, aby wyświetlić zmiany wprowadzone przez określonego użytkownika.Symbol gwiazdki (*) zawiera dane na temat zmian od wszystkich użytkowników (ustawienie domyślne).

/version:versionspec

Określa jedno z następujących ograniczeń dla danych historii:

  • Wersja maksymalna

  • Minimalne i maksymalne wersje korzystające ze składni zakresu ~.

Wartością domyślną jest /version:W (wersja w obszarze roboczym).

Aby uzyskać składnię, zobacz Odniesienie do polecenia kontroli wersji programu Team Foundation.

Tej opcji nie można używać z opcją /slotmode.

Przykłady

Pobieranie historii pojedynczego pliku

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

Wyświetla wszystkie zmiany wprowadzone do program.cs w oknie Historia.

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

Wyświetla wszystkie zmiany wprowadzone do program.cs w oknie wiersza polecenia.Na przykład:

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

Pobieranie historii wszystkich elementów w folderze

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

Wyświetla wszystkie zmiany wprowadzone do wszystkich elementów w SolutionA (włączając te w podfolderach) w oknie historii.

Pobieranie historii ostatnich pięciu zmian wszystkich elementów w folderze

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

Wyświetla 5 ostatnich zmian wprowadzonych do wszystkich elementów w SolutionA (włączając te w podfolderach):

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

Pobieranie historii od wersji x i wcześniejszych

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

Wyświetla zmiany wprowadzone do wszystkich elementów w SolutionA (włączając te w podfolderach) w wersji 30 i wcześniejszych:

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

Pobieranie historii od dnia D i wcześniejszych

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

— lub —

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

Wyświetla zmiany wprowadzone do wszystkich elementów w SolutionA (włączając te w podfolderach) dnia 4/23/12 lub wcześniej:

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

Pobieranie historii od wersji x do wersji y

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

Wyświetla zmiany wprowadzone do wszystkich elementów w SolutionA (włączając te w podfolderach) między 4/12/2012 a 4/23/12:

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 

Pobieranie szczegółowej historii

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

Wyświetla szczegóły dotyczące zmian wprowadzonych do wszystkich elementów w SolutionA (włączając te w podfolderach) między 4/12/2012 a 4/23/12:

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

Pobieranie historii niecyklicznych operacji w folderze

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

Wyświetla historię SolutionA folder w oknie historii, która umożliwia poznawanie wcześniejszych zmian w folderze.Na przykład jeśli ostatnią zmianą folderu była zmiana nazwy, można rozwinąć zestaw zmian, aby zobaczyć zmiany, które miały miejsce przed zmianą nazwy.

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

Wyświetla ostatnią zmianę do folderu SolutionA w oknie wiersza polecenia.

Praca w Visual Studio

Porady

  • Porada Aby uzyskać więcej informacji dotyczących sposobu korzystania z okna Historia, zobacz Podgląd historii elementu.

  • Porada Aby uzyskać bardziej szczegółowe informacje na temat zestawu zmian (na przykład, chcesz zobaczyć skojarzone elementy robocze):

    • W oknie historii kliknij dwukrotnie zestaw zmian lub otwórz jego menu kontekstowe i wybierz polecenie Szczegóły zestawu zmian.

    • Z wiersza polecenia użyj Changeset Command.

  • Porada Aby uzyskać więcej informacji dotyczących zestawów zmian, zobacz Wyszukiwanie i podgląd zestawów zmian.

  • Porada Opcja /collection jest użyteczna podczas uruchamiania tego polecenia z konta użytkownika i komputera i nie ma obszaru roboczego mapowanego do Kolekcji projektu zespołowego, który zawiera elementy.

  • Porada Zobacz Przegląd wcześniejszych wersji i zarządzanie nimi.