Polecenie Historii (Kontrola wersji serwera Team Foundation)

  • Artykuł

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

Visual Studio 2019 | Visual Studio 2022

Polecenie Kontrola wersji serwera 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 jest określona /noprompt opcja, 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 /noprompt opcji:

  • Brief (ustawienie domyślne): wyświetla jeden wiersz dotyczący każdego zestawu zmian, w tym: numer identyfikatora, zmiany wprowadzone, 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 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 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 (ustawienie domyślne): od najnowszej do najstarszej poprawki.

Należy użyć /noprompt opcji 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 składni zakresu ~ . 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 pozycję Szczegóły zestawu zmian.

    • W wierszu polecenia użyj polecenia Changeset.

  • Ta opcja jest przydatna /collection 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

Dane wyjściowe:

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

W poniższym przykładzie zostaną wyświetlone wszystkie zmiany wprowadzone we wszystkich elementach rozwiązania 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

Poniższy przykład przedstawia pięć najnowszych zmian wprowadzonych w elementach w rozwiązaniu SolutionA, w tym w podfolderach, w oknie wiersza polecenia:

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

Dane wyjściowe:

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 rozwiązaniu A, w tym w podfolderach w wersji 30 i starszej, w oknie wiersza polecenia:

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

Dane wyjściowe:

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 usłudze 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

Dane wyjściowe:

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

W poniższym przykładzie przedstawiono zmiany wprowadzone we wszystkich elementach w usłudze SolutionA, w tym w podfolderach, między 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

Dane wyjściowe:

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 rozwiązaniu SolutionA, w tym w podfolderach między 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 /format:detailed

Dane wyjściowe:

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