Команда History
Отображает журнал изменений для одного или нескольких файлов и/или папок.
Необходимые разрешения
Для использования команды history необходимо иметь разрешение Чтение со значением Разрешить для всех файлов или папок, журнал которых требуется отобразить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf history itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/itemmode] [/noprompt] [/login:username,[password]] [/sort:ascending,descending] [/collection:TeamProjectCollectionUrl]
Параметры
Аргумент |
Описание |
|---|---|
itemspec |
Указывает файл или папку, для которой нужно отобразить журнал. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Параметры командной строки. |
versionspec |
Предоставляет значение, например C58, для параметра /version. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций версий для определения элементов, находящихся в области его действия, см. в разделе Синтаксис командной строки (управление версиями). |
number |
Определяет количество наборов изменений, включаемых в запрос журнала. |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей один и более файлов или папок, о которых необходимо отобразить историю изменений (например, http://myserver:8080/tfs/DefaultCollection). |
username |
Предоставляет значение для параметров /login и /user. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
Параметр |
Описание |
|---|---|
/version |
Указывает версию элементов, для которых нужно отобразить журнал изменений. По умолчанию Team Foundation использует версию рабочей области. Этот параметр не может использоваться вместе с параметром /slotmode. |
/stopafter |
Отображает журнал для заданных номеров наборов изменений. |
/recursive |
Извлекает исторические данные об элементах, расположенных по указанному пути. |
/user |
Фильтрует список изменений по имени пользователя. Для выбора всех пользователей можно использовать знак "звездочка" (*). Если параметр не указывается, будут выбраны все пользователи. |
/format |
Задает описания, отображаемые для исторических данных. Brief отображает одну строку о каждом наборе изменений. Detailed отображает полное описание набора изменений. Если параметр не указывается, отображаются краткие описания. |
/slotmode |
Отображает журнал изменений для всех элементов, когда-либо находившихся в указанном расположении пространства имен. Если файл был переименован, данный параметр выведет историю изменений для файла под старым и новым именем. |
/noprompt |
Отменяет отображение запросов на ввод данных пользователем. |
/itemmode |
Отображает журнал изменений для указанного элемента с уникальным путем. В отличие от параметра /slotmode, при переименовании файла этот параметр отображает журнал изменений для файла только под новым именем. |
/collection |
Указывает коллекцию командных проектов. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
/sort |
Сортировка журнал изменений для одного или нескольких файлов или папок в каком-либо из следующих заказов:
|
Заметки
Команда "history" открывает окно Журнал, в котором находятся кнопки Подробнее, Просмотреть и Сравнить. Кнопка Подробнее предназначена для отображения сведений о наборе изменений. Кнопка Просмотреть предназначена для отображения версий файлов. Кнопка Сравнить предназначена для сравнения версий файлов с текущей версией рабочей области, если выбрана только одна строка, или с двумя версиями, если выбраны две строки. Для копирования текстовых данных из выделенных строк в буфер обмена, воспользуйтесь параметром copy, доступном в контекстном меню окна "Журнал". Дополнительные сведения см. в разделе Использование окна журнала.
Для просмотра журнала для одного или нескольких файлов или папок служит команда history. Для каждого набора изменений, содержащего запрошенные элементы, Team Foundation в выходных данных отображает запись изменения. Сведения о наборе изменений включают информацию о пользователе, выполнившем изменение на сервере Team Foundation (подсистема контроля версий), о файлах и папках, для которых были сделаны ожидающие изменения, тип ожидающего изменения, номер набора изменений, дата и время создания набора изменений.
Если версия не указана, Team Foundation отображает весь журнал файла или папки. Если указывается спецификация одной версии, Team Foundation отображает сведения об элементе из этой версии обратно в версию 1. Если указывается диапазон версий (с использованием синтаксиса ~ ), выводится журнал для этих версий и всех версий, входящих в диапазон. Диапазон можно указать по возрастанию или по убыванию.
При использовании параметра /slotmode Team Foundation отображает журнал изменений для указанного элемента. Например, если файл был переименован, данный параметр выведет старое и новое имя. Поскольку параметр /slotmode задает диапазон различных элементов и версий, комбинировать параметры /slotmode и /version нельзя.
Для определения номера набора изменений, в котором был зафиксирован набор файлов, используйте команду history, после этого воспользуйтесь командой "changeset" для отображения дополнительных сведений о сущности набора изменений и операции возврата, в результате которой он был создан. Или в окне "Журнал" выберите строку и нажмите кнопку Подробнее.
Ссылки на другие команды Team Foundation, предоставляющие дополнительные сведения об элементах на сервере Team Foundation (подсистема контроля версий) и сопоставленной рабочей области, см. в разделе Информационные команды.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Примеры
В следующем примере отображаются изменения, произошедшие между набором изменений версии 5 и версии 8 для файла 1256.c.
c:\projects> tf history /version:C5~C8 1256.c
В следующем примере отображаются последние десять изменений для файла 314.cs.
c:\projects> tf history /stopafter:10 314.cs
В следующем примере отображаются подробные результаты отформатированного журнала раздела пространства имен файла 1256.c.
c:\projects> tf history /format:detailed /slotmode 1256.c
См. также
Ссылки
Синтаксис командной строки (управление версиями)
Основные понятия
Другие ресурсы
Команды служебной программы командной строки "tf"