Команда "add"

Обновлен: Ноябрь 2007

Добавляет файлы и папки из локальной файловой системы на сервер Team Foundation (подсистема контроля версий).

Примечание.
Результаты данной команды не отображаются на сервере Team Foundation (подсистема контроля версий) до тех пор, пока не будет выполнена операция возврата. Дополнительные сведения см. в разделе Практическое руководство. Возврат ожидающих изменений.

Необходимые разрешения

Для использования команды add необходимо быть владельцем рабочей области и иметь разрешение Извлечение со значением Разрешить для родительской папки новых элементов. Кроме того, при использовании /lock:checkout или /lock:checkin необходимо иметь разрешение Блокировка со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

tf add itemspec [/lock:none|checkin|checkout] [/type:filetype] 
[/noprompt] [/recursive] 

Параметры

Аргумент	Описание
itemspec	Определяет файлы или папки для добавления. Дополнительные сведения об анализе спецификаций элементов в системе Team Foundation для определения элементов, которые находятся в области ее действия, см. в разделе Синтаксис командной строки (Team System).
filetype	Используется с параметром "/type". Дополнительные сведения см. в разделе Типы файлов.

Параметр	Описание
/type	Переопределяет соответствующий тип файла и добавляет к серверу Team Foundation (подсистема контроля версий) файлы указанного типа. Дополнительные сведения см. в разделе Типы файлов. Тип файла определяется по первому килобайту его содержимого.
/lock	Указывает тип блокировки или снимает ее с элемента. Параметры блокировки None Элемент не заблокирован. Уже имеющаяся блокировка отменяется. Checkin Разрешает извлекать и редактировать элемент во всех рабочих областях, но запрещает возвращать изменения вне этой /workspace до явного снятия блокировки. Если указанный элемент заблокирован в другой рабочей области, операция блокировки завершается неудачей. Checkout Запрещает возврат или извлечение любого из указанных элементов до явного снятия блокировки. Если один из указанных элементов заблокирован другим пользователем или для одного из них имеются ожидающие изменения, операция блокировки завершается неудачей.
/noprompt	Отключает отображение запросов на ввод данных пользователем.
/recursive	Добавляет все элементы в указанном каталоге и всех его подкаталогах.

Заметки

Перед добавлением элемента к системе управления версиями необходимо настроить локальную рабочую область и выполнить сопоставления рабочей папки. Дополнительные сведения о начале работы см. в разделе Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки.

Команда Add является командой Ожидающие изменения. Добавление на сервер Team Foundation (подсистема контроля версий) указанных элементов будет отложено до завершения операции возврата из рабочей области. Для выполнения команды ожидающих изменений текущий каталог должен быть сопоставлен с соответствующей рабочей областью и сервером Team Foundation (подсистема контроля версий).

При использовании команды Add для добавления нового элемента к системе управления версиями, он будет размещен на сервере Team Foundation (подсистема контроля версий) после возврата последних изменений в рабочей области. Элемент добавится к списку ожидающих изменений для текущей рабочей области. Чтобы зафиксировать ожидающее добавление к серверу Team Foundation (подсистема контроля версий), нужно либо непосредственно вернуть добавленный файл, либо вернуть все ожидающие изменения в локальной рабочей области. Чтобы другой пользователь не смог добавить файл или папку с названием, совпадающим с одним из ожидающих изменений к серверу Team Foundation (подсистема контроля версий), для Checkout используется параметр /lock. Дополнительные сведения см. в разделе Практическое руководство. Возврат ожидающих изменений.

Если файл 314.cs был добавлен к системе управления версиями с помощью tf add /teamproject/projects/math/314.cs, каждая из этих папок считается отложенным добавлением (если они уже не существуют) до тех пор, пока не будут возвращены изменения. Если при возврате изменений какие-либо из папок не существует по указанному пути (/teamproject, /teamproject/projects или /teamproject/projects/math) на сервере Team Foundation (подсистема контроля версий), Team Foundation создаст их.

Команда Add используется для установки исходной файловой структуры сервера Team Foundation (подсистема контроля версий). Дополнительные сведения см. в разделе Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки.

Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".

Примеры

В следующем примере файлы 314.c и 1256.c добавляются к списку ожидающих изменений для рабочей области, с которой связана папка C:\Pi.

c:\pi>tf add 314.cs 1256.c

В следующем примере к списку отложенных добавлений для текущей рабочей области присоединяются все файлы с кодом C# (CS-файлы) в текущем каталоге и всех его подкаталогах.

c:\projects>tf add *.cs /recursive

В следующем примере к списку отложенных добавлений для рабочей области, сопоставленной c:\projects, присоединяются все файлы и папки с именем, содержащим "hello" в текущем каталоге и всех его подкаталогах.

c:\projects>tf add *hello* /recursive

См. также

Задачи

Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки

Практическое руководство. Добавление в систему управления версиям файлов и папок, не относящихся к проекту или решению

Практическое руководство. Возврат ожидающих изменений

Практическое руководство. Блокировка и разблокировка папок и файлов

Основные понятия

Ожидающие изменения

Основные сведения о типах блокировки

Другие ресурсы

Команды служебной программы командной строки "tf"