Udostępnij za pośrednictwem

Polecenie historii (Kontrola wersji team foundation)

  • Artykuł

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

Visual Studio 2019 | Visual Studio 2022

Polecenie Kontroli wersji programu Team Foundation (TFVC) tf history wyświetla historię poprawek co najmniej jednego pliku lub folderów. Dane polecenia są wyświetlane w oknie historia w programie Visual Studio lub jeśli określono opcję /noprompt w wierszu polecenia.

Możesz również użyć programu Visual Studio, aby uzyskać historię poprawek. Aby uzyskać więcej informacji, zobacz Pobieranie historii elementu.

Wymagania wstępne

Zobacz domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

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, która zawiera elementy. Na przykład: http://myserver:8080/tfs/DefaultCollection.

Domyślnie kolekcja projektów jest przyjmowana jako kolekcja zawierająca obszar roboczy, który mapuje bieżący katalog.

/format

Określa, ile szczegółów ma być wyświetlanych dla każdego zestawu zmian po określeniu opcji /noprompt:

  • Brief (wartość domyślna): wyświetla jeden wiersz dotyczący każdego zestawu zmian, w tym: numer identyfikacyjny, wprowadzone zmiany, użytkownik, który dokonał zmian, daty i komentarza. Niektóre dane mogą być obcięte.

  • Detailed: wyświetla pełny opis każdego zestawu zmian. Oprócz powyższych informacji ta opcja wyświetla więcej danych, takich jak data z godziną, elementy zmienione, notatki zaewidencjonowania i ostrzeżenia zasad ewidencjonowania.

/itemmode

Nie można połączyć tej opcji z opcją /slotmode. Aby uzyskać więcej informacji, zobacz Matt Mitrik: zmiana trybu na miejsce w programie TFS 2010 Version Control.

<itemspec>

Określa elementy, dla których ma być wyświetlana historia. Aby uzyskać informacje o składni, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

/noprompt

Pomija wyświetlanie okien i okien dialogowych, takich jak okno historia, i przekierowuje dane wyjściowe do wiersza polecenia. Zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Nie wyświetla historii poprawek, które wystąpiły przed przeniesieniem elementu, zmianą nazwy, rozgałęzionym lub scalonym.

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

Określa konto użytkownika, aby uruchomić polecenie. Zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

/recursive

Rekursywnie pobiera dane historyczne na elementach w określonym katalogu i wszystkich podkatalogach.

/slotmode

Nie można połączyć tej opcji z opcją /itemmode. Aby uzyskać więcej informacji, zobacz Matt Mitrik: zmiana trybu na miejsce w programie TFS 2010 Version Control.

/sort

Sortuje historię poprawek dla co najmniej jednego pliku lub folderów w jednej z następujących kolejności:

  • Ascending: od najstarszej do najnowszej poprawki.

  • Descending (wartość domyślna): od najnowszej do najstarszej poprawki.

Należy 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 w celu wyświetlenia zmian wprowadzonych przez określonego użytkownika. Gwiazdka (*) symbol zawiera dane dotyczące zmian ze wszystkich użytkowników, czyli wartości domyślnej.

/version:<versionspec>

Określa maksymalną wersję lub minimalną i maksymalną wersję przy użyciu zakresu ~ składni. Wartość domyślna to /version:W, wersja w obszarze roboczym.

Nie można połączyć tej opcji z opcją /slotmode.

Aby uzyskać informacje o składni, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Uwagi

  • Aby uzyskać bardziej szczegółowe informacje o zestawie zmian, na przykład aby wyświetlić skojarzone elementy robocze:

    • W oknie Historia programu Visual Studio kliknij dwukrotnie lub kliknij prawym przyciskiem myszy zestaw zmian i wybierz szczegóły zestawu zmian.

    • W wierszu polecenia użyj polecenia Changeset.

  • Opcja /collection jest przydatna do uruchamiania tego polecenia z komputera i konta użytkownika, które nie ma obszaru roboczego zamapowanego na kolekcję projektów zawierającą elementy.

Przykłady

W poniższych przykładach przyjęto założenie, że c:\code\SiteApp\Main mapuje na folder główny w obszarze roboczym.

Pobieranie historii pojedynczego pliku

Poniższy przykład przedstawia wszystkie zmiany wprowadzone w program2.cs w oknie Historia.

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

Poniższy przykład przedstawia wszystkie zmiany wprowadzone w program2.cs w oknie wiersza polecenia.

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

Wyjście:

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

Poniższy przykład przedstawia wszystkie zmiany wprowadzone we wszystkich elementach w SolutionA, w tym w podfolderach, w oknie Historia.

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

Pobieranie historii ostatnich pięciu zmian we wszystkich elementach w folderze

W poniższym przykładzie przedstawiono pięć najnowszych zmian wprowadzonych w elementach w SolutionA, w tym w podfolderach, w oknie wiersza polecenia:

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

Wyjście:

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 z wersji x i starszych

Poniższy przykład przedstawia zmiany wprowadzone we wszystkich elementach w SolutionA, w tym w podfolderach w wersji 30 i starszych w oknie wiersza polecenia:

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

Wyjście:

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 z daty D i wcześniejszych

W poniższych przykładach są wyświetlane zmiany wprowadzone we wszystkich elementach w SolutionA, w tym w podfolderach 4/23/12 lub starszym w oknie wiersza polecenia:

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

Wyjście:

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 z zakresu dat

Poniższy przykład przedstawia zmiany wprowadzone we wszystkich elementach w SolutionA, w tym w podfolderach w latach 4/12/2012 i 4/23/2012 w oknie wiersza polecenia:

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

Wyjście:

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

Uzyskiwanie szczegółowej historii

W poniższym przykładzie przedstawiono szczegółowe informacje o zmianach wprowadzonych we wszystkich elementach w SolutionA, w tym w podfolderach w latach 12.04.2012 i 4.23.2012 w oknie wiersza polecenia:

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

Wyjście:

-------------------------------------------------------------------------------
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 niecyklicznej folderu

Poniższy przykład przedstawia historię folderu SolutionA w oknie historia programu Visual Studio, co umożliwia eksplorowanie wcześniejszych zmian w folderze. Jeśli na przykład ostatnia zmiana folderu została zmieniona, możesz rozwinąć zestaw zmian, aby zobaczyć zmiany, które wystąpiły przed zmianą nazwy.

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

Poniższy przykład przedstawia najnowszą zmianę folderu SolutionA w oknie wiersza polecenia.

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