Команда "get"
Обновлен: Ноябрь 2007
Извлекает предназначенную только для чтения копию файла с сервера Team Foundation в рабочую область и создает папки на диске для ее хранения.
Необходимые разрешения
Для использования команды get необходимо иметь разрешение Чтение со значением Разрешить для каждого извлекаемого элемента и быть владельцем целевой рабочей области или иметь глобальное разрешение Администрирование рабочих областей. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf get itemspec [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/remap] [/noprompt]
Параметры
Аргумент |
Описание |
|---|---|
Itemspec |
Файл или папка для извлечения. При отсутствии спецификации элемента itemspec Team Foundation Server выполняет рекурсивную операцию Get для текущей рабочей области. |
Versionspec |
Предоставляемое пользователем значение параметра /version. Дополнительные сведения об анализе спецификаций версий сервером Team Foundation Server для определения элементов, которые находятся в области его действия, см. в разделе Синтаксис командной строки (Team System). |
Параметр |
Описание |
|---|---|
/version |
Необязательная спецификация версии. Параметр versionspec содержит версию извлекаемого элемента. Возможны следующие варианты указания версии.
|
/all |
Принудительно извлекает все файлы, а не только устаревшие. |
/overwrite |
Перезаписывает не извлеченные изменяемые файлы. |
/force |
Объединяет параметры /all и /overwrite. |
/preview |
Отображает результат без фактического выполнения операции Get. |
/recursive |
Рекурсивно извлекает все элементы, соответствующие itemspec. |
/remap |
Для использования только с пакетом обновления 1 (SP1) для Microsoft Visual Studio Team System 2008 Team Foundation Server. Обновляет ссылки базы данных локальной повторно сопоставленной ветви для всех элементов, содержимое которых на локальном диске совпадает с содержимым, загружаемым из ветви в системе управления версиями. |
/noprompt |
Отключает вывод всех диалоговых окон, которые могут отображаться в ходе этой операции. |
Заметки
Команда get извлекает элементы с сервера в рабочую область. Если версия не указана, извлекается последняя версия на сервере. При выполнении операции get Team Foundation Server удаляет с сервера все файлы, которые локально помечены для удаления и которые были возвращены после последней синхронизации рабочей области и сервера. Переименованные или перемещенные файлы на сервере будут перемещены на диске в соответствии с изменениями, сделанными на сервере. Кроме того, переименованные или перемещенные файлы на сервере будут перемещены в локальной рабочей области в соответствии с изменениями, сделанными на сервере.
Команда get не перезаписывает файлы, извлеченные в локальный каталог рабочей области. При использовании команды get для уже извлеченного элемента в рабочей области и изменении версии на сервере, выдается запрос на разрешение конфликта между версией в рабочей области и версией на сервере. Дополнительные сведения см. в разделе Команда "resolve".
Параметр /all следует использовать, если версия в рабочей области совпадает с серверной версией и требуется заменить файлы на диске.
Параметр /overwrite используется для принудительной перезаписи текущей версии рабочей области указанной версией с сервера.
Параметр /force используется для перезаписи всех извлеченных элементов в рабочей области последними версиями с сервера. Параметр /force можно также использовать для перезаписи определенной версии.
Параметр /preview используется для просмотра изменений, которые возникнут при выполнении следующей операции get.
.gif "Примечание") Примечание. |
|---|
Команда get часто используется для поддержания актуального состояния рабочей области с тем, чтобы быстро устранить различия между локальной и серверной версиями проекта. |
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Использование команды Get с параметром /remap
Использование параметра /remap позволяет сократить время загрузки при повторном сопоставлении локальной папки с новой или другой ветвью. Пример
Ветвь $/branch1 сопоставляется с папкой D:\branch на локальном компьютере.
Выполняется команда tf get, чтобы скопировать все элементы из ветви $/branch1 в локальную папку.
Изменяется сопоставление ветви $/branch1, а затем ветвь $/branch2 сопоставляется с локальной папкой, ранее сопоставленной с ветвью $/branch1 (D:\branch).
Выполняется команда tf get с параметром /remap, чтобы обеспечить загрузку только того содержимого ветви $/branch2, которое отлично от содержимого в ветви $/branch1 в локальной папке (D:\branch).
| Примечание. |
|---|
Эта возможность доступна, только если установлен пакет обновления 1 (SP1) для Microsoft Visual Studio Team System 2008 Team Foundation Server. |
Примеры
В следующем примере с сервера извлекается последняя версия файла "314.cs". Если для файла "314.cs" существуют ожидающие изменения, Team Foundation Server предложит разрешить конфликты.
C:\projects>tf get 314.cs
В следующем примере с сервера извлекается версия 8 файла "1256.cs".
| Примечание. |
|---|
"1256.cs;8" является эквивалентом "1256.cs;C8". По умолчанию, если после точки с запятой стоит только число, то используется версия набора изменений. |
C:\>tf get 1256.cs;8
В следующем примере из папки сервера и вложенных папок извлекаются последние версии всех незамаскированных элементов в каталог "C:\projects" и создаются необходимые локальные папки. Подробные сведения о маскировании папок и снятии маскировки см. в разделе Команда "workfold".
C:\projects>tf get
В следующем примере представлены альтернативные способы извлечения версии файла "1256.cs", который был возвращен с набором изменений "1999".
c:\projects>tf get /version:C1999 1256.cs
или
c:\projects>tf get 1256.cs;C1999
В следующем примере с сервера извлекаются версии всех незамаскированных элементов, существовавших на сервере при создании набора изменений 271.
c:\projects>tf get /version:C271
В следующем примере извлекается "build42" с меткой "build42". Рабочая область будет совпадать с меткой до появления ожидающих изменений. Все файлы без метки удаляются с локального диска.
c:\projects>tf get /version:Lbuild42
В следующем примере с сервера извлекается версия файла с определенной датой и временем.
c:\projects>tf get /version:D2008-01-21T16:00
См. также
Задачи
Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки
Практическое руководство. Получение исходного кода для командного проекта
Практическое руководство. Маскировка и отмена маскировки папок в рабочей области