Поделиться через


Команда History

Отображает журнал изменений одного или нескольких файлов или папок.Данные отобразятся в окне журнала или если параметр задан, то /noprompt в командной строке.

Требования: см. Разрешения 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]

Параметры

Параметр

Описание

/collection: TeamProjectCollectionUrl

Задает URL-адрес коллекции командных проектов, которая содержит элементы.Например: http://myserver:8080/tfs/DefaultCollection.

Предполагается, что по умолчанию коллекция командных проектов одно, которое содержит рабочую область, которая сопоставляет текущую папку.

/format

Указывает, какой объем данных, отображаемых о каждом наборе изменений, если был указан параметр /noprompt:

  • Brief (по умолчанию): Отображает одну линию о каждом наборе изменений, включают: Идентификационный номер изменения, пользователь, выполнивший изменения, дату, и комментарий.Некоторые из данных могут быть усечены.

  • Detailed: Отображает полное описание каждого набора изменений.В дополнение к вышеуказанному сведения, этот параметр указывает дополнительные данные в виде даты с временем, измененные элементы, примечания при возврате и предупреждения политики возврата.

/itemmode

Этот параметр не может использоваться вместе с параметром /slotmode.См. раздел Matt Mitrik: Изменить, чтобы прорезать режим в элементе управления версиями Team Foundation Server 2010.

itemspec

Определяет элементы, для которых отобразить журнал.Синтаксис см. в разделе Справочные сведения о командах Team Foundation (подсистема контроля версий).

/noprompt

Этот параметр.

  • Отключает отображение окна и диалоговые окна (например, окно Журнал ) и перенаправляет выходные данные в командной строке.Дополнительные сведения см. в разделе Справочные сведения о командах Team Foundation (подсистема контроля версий).

  • Отображает журнал изменений, которые произошли перед тем, как был перемещен, переименован, был разрешен разветвление или объединяется элемент.

/login:username,[password]

Определяет учетную запись пользователя, чтобы выполнить команду.Дополнительные сведения см. в разделе Справочные сведения о командах Team Foundation (подсистема контроля версий).

/recursive

Рекурсивно извлекает исторические данные элементов в указанном каталоге и всех подкаталогах.

/slotmode

Этот параметр не может использоваться вместе с параметром /itemmode.См. раздел Matt Mitrik: Изменить, чтобы прорезать режим в элементе управления версиями Team Foundation Server 2010.

/sort

Сортировка журнал изменений для одного или нескольких файлов или папок в каком-либо из следующих заказов:

  • Ascending: от старых к самой последней версии.

  • Descending (по умолчанию): в большинстве новостей самому старому к изменению.

Необходимо использовать параметр /noprompt с этим параметром.

/stopafter:number

Указывает максимальное количество наборов изменений для отображения в данных журнала.

/user:username

Фильтрует данные за длительный период, чтобы отобразить изменения, произведенные заданным пользователем.Символ звездочки (*) включает информацию об изменениях из всех пользователей (по умолчанию).

/version:versionspec

Задает одно из следующих ограничений на данных журналов:

  • Максимальная скорость

  • Минимальные и максимальные версии с использованием синтаксиса ~ диапазона.

Значение по умолчанию /version:W (версия в рабочей области).

Синтаксис см. в разделе Справочные сведения о командах Team Foundation (подсистема контроля версий).

Этот параметр не может использоваться вместе с параметром /slotmode.

Примеры

yxtbh4yh.collapse_all(ru-ru,VS.110).gifПолучение одного файла журнала

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

Отображает все изменения, внесенные в program.cs в окне журнала.

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

Отображает все изменения, внесенные в program.cs в окне командной строки.Примеры.

Changeset Change                     User              Date       Comment
--------- -------------------------- ----------------- ---------- -------- 
29        edit                       Peter Waxman      4/23/2012  Fix bug
20        add                        Julia Ilyina      4/12/2012  Add new  

yxtbh4yh.collapse_all(ru-ru,VS.110).gifПолучите журнал всех элементов в папке

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

Отображает все изменения ко всем элементам в SolutionA (в том числе во вложенных папках) в поле журнал.

yxtbh4yh.collapse_all(ru-ru,VS.110).gifПолучение журнала 5 последних изменений на все элементы в папке

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

Указывает последние 5 записей изменений к элементам в SolutionA (в том числе во вложенных папках):

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
31        Julia Ilyina      5/15/2012
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to Proje
15        Julia Ilyina      4/8/2012

yxtbh4yh.collapse_all(ru-ru,VS.110).gifПолучите журнал от версии x и предыдущего

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

Отображает сделанные изменения ко всем элементам в SolutionA (в том числе во вложенных папках) в версии 30 и выше.

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to 15        Julia Ilyina      4/8/2012

yxtbh4yh.collapse_all(ru-ru,VS.110).gif Получите журнал из D даты и выше

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

- или -

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

Отображает изменения, сделанные ко всем элементам в SolutionA (в том числе во вложенных папках) on 4/23/12 или выше.

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to 15        Julia Ilyina      4/8/2012

yxtbh4yh.collapse_all(ru-ru,VS.110).gifПолучите журнал от версии к версии x y

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

Отображает сделанные изменения ко всем элементам в SolutionA (в том числе во вложенных папках) между 4/12/2012 и 4/23/12:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Julia Ilyina      4/23/2012
29        Peter Waxman      4/23/2012  Fix bug in new method
20        Julia Ilyina      4/12/2012  Add new method, add program2.cs to 

yxtbh4yh.collapse_all(ru-ru,VS.110).gifGet детализировал журнал

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

Отображает сведения об изменениях, внесенных ко всем элементам в SolutionA (в том числе во вложенных папках) между 4/12/2012 и 4/23/12:

-------------------------------------------------------------------------------
Changeset: 30
User: Julia Ilyina (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: Julia Ilyina (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: Julia Ilyina (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:
    Peter 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.

yxtbh4yh.collapse_all(ru-ru,VS.110).gifПолучите нерекурсивный журнал папки

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

Отображает журнал папки SolutionA в окне " журнал ", которое позволяет исследовать более ранние изменения в папке.Например, если последнее изменение в папке было переименовать, то можно развернуть набор изменений, чтобы увидеть изменения, произошедшие до переименования.

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

Отображает последнее изменение в папке SolutionA в окне командной строки.

Работа в Visual Studio

Советы

  • Совет Сведения о том, как использовать окно Журнал см. в разделе Получение истории элемента.

  • Совет Чтобы получить более подробные сведения о наборе изменений (например, необходимо просмотреть связанные рабочие элементы):

    • В поле журнал, дважды щелкните набор изменений или открыть его контекстное меню, и выберите Сведения о наборе изменений.

    • Из командной строки используйте Changeset Command.

  • Совет Дополнительные сведения о наборах изменений см. в разделе Поиск и просмотр наборов изменений.

  • Совет Параметр /collection полезен для выполнения этой команды с компьютера и учетной записи пользователя, которая не имеет области, сопоставленное к коллекции командных проектов, которая содержит элементы.

  • Совет Дополнительные сведения см. в разделе Просмотр прошлых версий и управление ими.