Команда Add
Добавляет файлы и папки из локальной файловой системы на сервер для Team Foundation (подсистема контроля версий).
Примечание
Результаты данной команды не отражаются на сервере Team Foundation (подсистема контроля версий) до тех пор, пока не будет выполнена операция возврата.Дополнительные сведения см. в разделе Возврат ожидающих изменений.
Необходимые разрешения
Для использования команды add необходимо обладать рабочей областью и иметь разрешение Извлечение со значением Разрешить для родительской папки новых элементов. Разрешению Блокировка также необходимо задать Разрешить, если используются /lock:checkout или /lock:checkin. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf add itemspec [/lock:(none|checkin|checkout)] [/type:filetype]
[/noprompt] [/recursive] [/login:username,[password]]
Параметры
Аргумент |
Описание |
|---|---|
itemspec |
Определяет файлы или папки для добавления. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Синтаксис командной строки (управление версиями). .gif "Примечание") Примечание
Можно указать более одного аргумента Itemspec.
|
filetype |
Используется с параметром "/type". Дополнительные сведения см. в разделе Управление типами файлов. |
username |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как домен\имя_пользователя или как имя_пользователя. |
Параметр |
Описание |
|---|---|
/type |
Переопределяет соответствующий тип файла и добавляет к серверу Team Foundation (подсистема контроля версий) файлы указанного типа. Дополнительные сведения см. в разделе Управление типами файлов. Тип файла определяется по первому килобайту его содержимого. |
/lock |
Указывает тип блокировки или снимает ее с элемента. Параметры блокировки
|
/noprompt |
Отменяет отображение запросов на ввод данных пользователем. |
/recursive |
Добавляет все элементы в указанном каталоге и всех его подкаталогах. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
Заметки
Перед добавлением элемента к системе управления версиями необходимо настроить локальную рабочую область и выполнить сопоставления рабочей папки.
Команда 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 (подсистема контроля версий).
Дополнительные сведения о поиске программы командной строки 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
См. также
Задачи
Добавление в систему управления версиям файлов и папок, не относящихся к проекту или решению
Блокировка и разблокировка папок и файлов
Основные понятия
Основные сведения о типах блокировки