Команда Get (система управления версиями Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Команда система управления версиями Team Foundation (TFVC) get
получает или загружает последнюю версию или указанную версию одного или нескольких файлов или папок из Azure DevOps Server в рабочую область. Команда tf get
предоставляет другой пользовательский интерфейс, отличный от Visual Studio, но процесс в основном такой же. Дополнительные сведения об использовании Visual Studio для получения файлов и папок см. в разделе "Скачивание (получение) файлов с сервера.
Необходимые компоненты
См . разрешения TFVC по умолчанию.
Синтаксис
tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]
Параметры
Параметр
Description
/all
Этот параметр можно использовать для восстановления элемента, который вы случайно удалили из рабочей области сервера. Если вы используете локальную рабочую область, которая рекомендуется, вряд ли вам придется использовать этот параметр.
TFVC сохраняет внутреннюю запись всех элементов, содержащихся в рабочей области, включая версию каждой из них. По умолчанию при получении файлов, если внутренняя запись на сервере указывает, что рабочая область уже имеет полученную версию, она не извлекает элемент. Этот параметр получает все элементы независимо от данных, содержащих внутреннюю запись.
/force
Объединяет /all
и /overwrite
.
<itemspec>
Указывает область получения элементов. Можно указать несколько itemspec
аргументов. Если нет itemspec
, система рекурсивно получает все элементы в текущей рабочей области.
Синтаксис см. в разделе "Использование команд управления версиями Team Foundation".
/login <username>,[<password>]
Указывает учетную запись пользователя для выполнения команды. См . команды управления версиями Team Foundation.
/noautoresolve
По умолчанию система автоматически пытается выполнить автоматическое восстановление всех конфликтов. Дополнительные сведения см. в разделе "Устранение конфликтов система управления версиями Team Foundation". Укажите этот параметр, чтобы отключить это поведение по умолчанию.
/noprompt
Подавляет отображение окон и диалоговых окон Visual Studio и перенаправляет выходные данные в командную строку. См . команды управления версиями Team Foundation.
/overwrite
По умолчанию система не получает элемент, если он доступен для записи, то есть его атрибут только для чтения очищается на клиентском компьютере. Этот параметр переопределяет поведение по умолчанию и перезаписывает записываемый элемент, если этот элемент не извлечен. Если вы используете локальную рабочую область , как рекомендуется, вряд ли вам придется использовать этот параметр.
/preview
Отображает то, что произойдет, без фактического get
выполнения операции.
/recursive
Рекурсивно получает элементы в указанном каталоге и любых подкаталогах. Если этот параметр не указан itemspec
, этот параметр подразумевается.
/remap
/version:<versionspec>
Указывает максимальную версию или минимальную и максимальную версию, отображаемую в данных журнала. Значение по умолчанию — /version:T
последняя версия.
Синтаксис см. в разделе "Использование команд управления версиями Team Foundation".
Замечания
Если вы начинаете новую задачу, скорее всего, рекомендуется скачать
tf get
последние файлы с сервера перед извлечением файлов и начать работу. Вы можете запускатьсяtf get
из любой папки в рабочей области.При необходимости создает папки на диске,
tf get
чтобы содержать дочерние элементы, скачиваемые командой.Вы можете просмотреть сведения о журнале элемента с помощью команды "Журнал" и команды "Набор изменений".
Если вы беспокоитесь о том, какие изменения могут произойти в файлах в рабочей области, можно использовать
/preview
этот параметр, чтобы увидеть изменения, которые будут возникать без фактической реализации.Конфликты могут блокировать ваши
get
. Типичным причиной конфликтов является попытка получить элемент, на котором у вас есть ожидающие изменения. Чтобы устранить эти конфликты, можно использовать команду "Разрешить".
Примеры
В следующих примерах предполагается, что $/SiteApp/Main/
сопоставляется с c:\code\SiteApp\Main\
рабочей областью.
Получение последней версии всех элементов в рабочей области
По умолчанию tf get
команда получает последние версии всех элементов в рабочей области. Например, следующая команда рекурсивно получает все файлы, $/SiteApp/Main/
включая все дочерние папки.
c:\code\SiteApp\Main>tf get
Рекурсивно получить последнюю версию элементов определенного типа в папке
В следующем примере возвращается последняя версия всех файлов C#в c:\code\SiteApp\Main\SolutionA\Project1.
c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive
Получение последней версии файла
В следующем примере возвращается последняя версия program.cs в Project1.
c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs
Получение определенной версии файла
В следующем примере возвращается версия 8 program.cs в Project1.
c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8
Получение последней версии двух файлов
Следующий пример получает последние версии file1.cs и file2.cs в Project1.
c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs
Синхронизация рабочей области для сопоставления версии базы кода команды
В следующем примере рабочая область синхронизируется, чтобы она соответствовала базе кода, как она существовала при создании набора изменений 15:
c:\code\SiteApp\Main>tf get /v:15
- Имя и содержимое каждого элемента в рабочей области изменяется на соответствие состоянию, в котором он был на сервере.
- Элементы, которые были удалены после этого набора изменений, восстанавливаются в рабочей области.
- Элементы, добавленные после этого набора изменений, удаляются из рабочей области.
Синхронизация рабочей области для сопоставления с помеченной версией базы кода команды
В следующем примере рабочая область синхронизируется с элементами в базе кода, помеченнымиLastKnownGood
:
c:\code\SiteApp\Main>tf get /v:LLastKnownGood
- Имя и содержимое каждого помеченного элемента в рабочей области изменяется на соответствие состоянию, в котором он был на сервере.
- Удаленные элементы, которые были удалены, восстанавливаются в рабочей области.
- Элементы, которые не помечены на сервере, удаляются из рабочей области.