Команда Shelve

Статья
08/11/2011

Хранит набор ожидающих изменений вместе с примечаниями при возврате, комментарием и списком связанных рабочих элементов на сервере, на котором выполняется Visual Studio Team Foundation Server, не выполняя их фактический возврат в систему управления версиями.

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

Если требуется использовать команду shelve для удаления набора изменений, необходимо быть владельцем набора изменений или иметь разрешение Администрирование изменений, включенных в набор изменений со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

tf shelve  [/replace] [/comment:("comment"|@commentfile)] [shelvesetname] [/validate][/noprompt] [/login:username,[password]]

tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)] 
[/recursive] [shelvesetname] itemspec [/validate] [/noprompt] [/login:username,[password]]

tf shelve /delete shelvesetname[;owner] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Параметры

Аргумент	Описание
commentfile	Указывает путь к файлу в системе, содержащему комментарии для набора отложенных изменений.
comment	Указывает комментарий для набора отложенных изменений.
itemspec	Определяет файлы или папки для включения в набор отложенных изменений. По умолчанию, если параметр не указан, в набор отложенных изменений включаются все отложенные изменения в текущей рабочей области. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Параметры командной строки.
shelvesetname	Указывает имя, по которому набор отложенных изменений извлекается с сервера Team Foundation. Указание существующего сочетания имя_набора_отложенных_изменений и владелец возможно только при указании параметра /replace . Для данного параметра необходимо предоставить значение.
owner	Определяет текущего или предполагаемого владельца набора отложенных изменений по имени пользователя. По умолчанию владельцем назначается текущий пользователь, если не указано иное.
username	Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя.
TeamProjectCollectionUrl	URL-адрес коллекции командных проектов, содержащей файлы или папки, которую необходимо включить в набор отложенных изменений (например, http://myserver:8080/tfs/DefaultCollection/).

Параметр	Описание
/move	Удаляет ожидающие изменения из рабочей области после успешного завершения операции включения в набор отложенных изменений.
/replace	Заменяет существующий набор отложенных изменений с тем же именем и владельца на указанные.
/delete	Удаляет указанные наборы отложенных изменений. Вместе с ним может использоваться только параметр /server. Если параметр /noprompt не используется, при указании параметра без /delete будет выводиться сообщение о подтверждении.
/comment	Добавляет указанный комментарий с описанием включенных в набор отложенных изменений.
/recursive	Включает в набор отложенных изменений все элементы в указанной папке и всех ее вложенных папок, если предоставленный элемент является папкой.
/noprompt	Отменяет отображение запросов на ввод данных пользователем.
/validate	Не может использоваться вместе с параметром /noprompt. Этот параметр выбирается путем установки флажка для проверки в открывшемся диалоговом окне Включить в набор изменений — Исходные файлы. При установке флажка будет произведена проверка на соответствие политикам возврата и заполнение примечаний при возврате. Это параметр полезен, если проверку и возврат выполняет другой пользователь.
/login	Задает имя пользователя и пароль для проверки подлинности пользователя с Team Foundation Server.
/collection	Указывает коллекцию командных проектов.

Заметки

Команда shelve программы командной строки tf производит резервное копирование ожидающих изменений, список связанных рабочих элементов, незавершенных примечаний при возврате и комментариев в наборе отложенных изменений на Team Foundation Server. Набор отложенных изменений — совокупность изменений, не зафиксированных на сервере. Набор отложенных изменений извлекается с сервера в рабочую область любым пользователем, имеющим достаточные разрешения.

Включение изменений в отложенных набор является альтернативой возврата ожидающих изменений, которые не были протестированы в достаточной степени. Используйте функцию включения в набор отложенных изменений в следующих случаях, когда требуется прервать работу.

Совместное использование набора локальных рабочих файлов с другим разработчиком или тестировщиком без возврата изменений на сервер системы управления версиями.
Временное прекращение работы с группой ожидающих изменений без их возврата для выполнения более приоритетной задачи. После завершения более важных задач отложенные изменения восстанавливаются с помощью команды Команда Unshelve.

При использовании параметра /move команда shelve откатит все включенные в набор отложенных изменений версии файла до базовой версии рабочей области, являющейся последней версией, полученной с сервера для текущей области. В частности, параметр /move гарантирует, что для всех отложенных элементов выполняются следующие действия.

Команда Undo отменяет отложенные изменения. Добавленные ожидающие файлы удаляются из рабочей области.
В текущую рабочую область будут извлечены основные версии рабочей области всех файлов, для которых существуют ожидающие изменения.
Все элементы рабочей области доступны только для чтения.

При включении параметра /delete Team 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

См. также

Поделиться через

Команда Shelve

Параметры

Заметки

Примеры

См. также

Задачи

Ссылки

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

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

Дополнительные ресурсы