Команда "shelve"
Обновлен: Ноябрь 2007
Хранит набор ожидающих изменений вместе с примечаниями при возврате, комментарием и списком связанных рабочих элементов на Team Foundation Server, не выполняя их фактический возврат в систему управления версиями.
Требуемые разрешения
Для использования команды shelve необходимо быть владельцем набора отложенных изменений или иметь разрешение Администрирование изменений, включенных в набор изменений со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf shelve [/replace] [/comment:("comment"|@commentfile)] [shelvesetname[;owner] [/validate]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)]
[/recursive] shelvesetname[;owner] itemspec [/validate]
tf shelve /delete [/server:servername] shelvesetname[;owner] [/validate]
Параметры
Аргумент |
Описание |
|---|---|
commentfile |
Указывает путь к файлу в системе, содержащему комментарии для набора отложенных изменений. |
comment |
Указывает комментарий для набора отложенных изменений. |
servername |
Предоставляемое пользователем значение параметра /server. |
itemspec |
Определяет файлы или папки для включения в набор отложенных изменений. По умолчанию, если параметр не указан, в набор отложенных изменений включаются все отложенные изменения в текущей рабочей области. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Параметры командной строки. |
shelvesetname |
Указывает имя, по которому набор отложенных изменений извлекается с сервера Team Foundation. Указание существующего сочетания имя_набора_отложенных_изменений и владелец возможно только при указании параметра /replace . Для данного параметра необходимо предоставить значение. |
owner |
Определяет текущего или предполагаемого владельца набора отложенных изменений по имени пользователя. По умолчанию владельцем назначается текущий пользователь, если не указано иное. |
Параметр |
Описание |
|---|---|
/move |
Удаляет ожидающие изменения из рабочей области после успешного завершения операции включения в набор отложенных изменений. |
/replace |
Заменяет существующий набор отложенных изменений с тем же именем и владельца на указанные. |
/delete |
Удаляет указанные наборы отложенных изменений. Вместе с ним может использоваться только параметр /server. Если параметр /noprompt не используется, при указании параметра без /delete будет выводиться сообщение о подтверждении. |
/comment |
Добавляет указанный комментарий с описанием включенных в набор отложенных изменений. |
/recursive |
Включает в набор отложенных изменений все элементы в указанной папке и всех ее вложенных папок, если предоставленный элемент является папкой. |
/server |
Указывает сервер Team Foundation (подсистема контроля версий), на котором будет создан, изменен или удален набор отложенных изменений. |
/noprompt |
Отменяет отображение запросов на ввод данных пользователем. |
/validate |
Не может использоваться вместе с параметром /noprompt. Этот параметр выбирается путем установки флажка для проверки в открывшемся диалоговом окне Включить в набор изменений — Исходные файлы. При установке флажка будет произведена проверка на соответствие политикам возврата и заполнение примечаний при возврате. Это параметр полезен, если проверку и возврат выполняет другой пользователь. |
Заметки
Команда shelve программы командной строки tf производит резервное копирование ожидающих изменений, список связанных рабочих элементов, незавершенных примечаний при возврате и комментариев в наборе отложенных изменений на Team Foundation Server. Набор отложенных изменений — совокупность изменений, не зафиксированных на сервере. Набор отложенных изменений извлекается с сервера в рабочую область любым пользователем, имеющим достаточные разрешения.
Включение изменений в отложенных набор является альтернативой возврата ожидающих изменений, которые не были протестированы в достаточной степени. Используйте функцию включения в набор отложенных изменений в следующих случаях, когда требуется прервать работу.
Совместное использование набора локальных рабочих файлов с другим разработчиком или тестировщиком без возврата изменений на сервер системы управления версиями.
Временное прекращение работы с группой ожидающих изменений без их возврата для выполнения более приоритетной задачи. После завершения более важных задач отложенные изменения восстанавливаются с помощью команды Команда "unshelve".
При использовании параметра /move команда shelve откатит все включенные в набор отложенных изменений версии файла до базовой версии рабочей области, являющейся последней версией, полученной с сервера для текущей области. В частности, параметр /move гарантирует, что для всех отложенных элементов выполняются следующие действия.
Команда Undo отменяет отложенные изменения. Добавленные ожидающие файлы удаляются из рабочей области.
В текущую рабочую область будут извлечены основные версии рабочей области всех файлов, для которых существуют ожидающие изменения.
Все элементы рабочей области доступны только для чтения.
При включении параметра /deleteTeam Foundation окончательно удалит указанный набор отложенных изменений с сервера Team Foundation.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Примеры
В следующем примере на Team Foundation Server создается набор отложенных изменений с именем "Reflector_BuddyTest", владельцем назначается пользователь с именем "Hans", затем все элементы возвращаются в рабочую область с последней версией, загруженной во время последней операции get, и устанавливается состояние только для чтения.
c:\projects> tf shelve Reflector_BuddyTest;Hans /move
В следующем примере с сервера удаляется существующий набор отложенных изменений "new-feature", создается новый набор отложенных изменений с тем же именем и в текущей области сохраняются все ожидающие изменения.
c:\projects> tf shelve new-feature /replace
В следующем примере создается набор отложенных изменений "HelloWorld_TestMe », включающий в себя все ожидающие изменения, сделанные во всех файлах рабочей папки "C:\projects" и всех ее вложенных папках.
c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive
В следующем примере удаляется набор отложенных изменений "HelloWorld_24".
c:\projects> tf shelve HelloWorld_24 /delete
См. также
Задачи
Практическое руководство. Включение в набор и восстановление ожидающих изменений
Основные понятия
Работа с наборами отложенных изменений системы управления версиями
Ссылки
Синтаксис командной строки (Team System)