Команда "unshelve"
Обновлен: Ноябрь 2007
Восстанавливает версии файлов отложенных изменений, примечания при возврате, комментарии и связи с рабочим элементом в текущей рабочей области или удаляет существующий набор отложенных изменений с сервера.
Необходимые разрешения
Для использования команды unshelve необходимо иметь разрешение Чтение со значением Разрешить и разрешение Извлечение для элементов в наборе отложенных изменений со значением Разрешить. Кроме того, чтобы удалить набор отложенных изменений, необходимо быть его владельцем или иметь глобальное разрешение Администрирование изменений, включенных в набор отложенных изменений со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf unshelve [/move] [shelvesetname[;ownername]] itemspec
[/recursive] [/noprompt]
Параметры
Аргумент |
Описание |
|---|---|
shelvesetname |
Имя набора отложенных изменений, которое необходимо восстановить. |
ownername |
Имя владельца набора отложенных изменений. |
Itemspec |
Определяет изменения файла или папки для восстановления из набора изменений в текущую рабочую область. Если этот параметр не используется, все ожидающие изменения в указанном наборе отложенных изменений восстанавливаются по умолчанию. Указание путей к серверу не допускается. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Параметры командной строки. |
Параметр |
Описание |
|---|---|
/move |
Удаляет указанный набор отложенных изменений с сервера Team Foundation после успешного выполнения операции восстановления из набора изменений. Этот параметр нельзя использовать вместе с параметром itemspec. Набор отложенных изменений можно также удалить с помощью команды shelve. |
/recursive |
Если параметр указан, выполняется рекурсивный поиск спецификации элемента. |
/noprompt |
Если параметр указан, запрос на ввод данных отображаться не будет. |
Заметки
Команда unshelve программы командной строки tf извлекает либо все изменения отложенного файла, либо определенное подмножество всех изменений отложенного файла с сервера Team Foundation в текущую рабочую область.
При восстановлении элемента из набора изменений в конечной рабочей области не должно быть никаких отложенных изменений относительно него.
При восстановлении набора отложенных изменений Team Foundation восстанавливает каждое отложенное изменение в конечную рабочую область как ожидающее изменение, при условии, что это изменение не конфликтует с другим ожидающим изменением, которое уже находилось в рабочей области. Дополнительные сведения о процессе восстановления из набора изменений см. в разделе Работа с наборами отложенных изменений системы управления версиями.
Команду unshelve можно использовать для восстановления отдельных изменений файлов из набора отложенных изменений в рабочую область. После процесса восстановления необходимо выполнить команду get для согласования изменений, возвращенных на сервер с момента создания набора отложенных изменений.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Повторное использование отложенных изменений
Если отложенные изменения необходимо интегрировать в текущую рабочую область для постоянного внесения изменений, восстановите нужный набор отложенных изменений. После восстановления рекомендуется установить последнюю версию файлов управления версиями.
Восстановление из набора изменений и просмотр кода другого пользователя
Набор отложенных изменений можно также восстановить для просмотра изменений из рабочей области другого пользователя. Существует две возможности восстановления.
Если отложенные элементы и связанные с ними элементы не были изменены или изменены незначительно с момента создания набора отложенных изменений, из рабочей области владельца набора можно извлечь базовую версию всех связанных элементов. Для этого воспользуйтесь вариантом команды tf get * /version;Wworkspacename, где workspacename — это имя рабочей области, из которой другие пользователи создали набор отложенных изменений.
Если с момента создания набора отложенных изменений прошло значительное время или рабочая область претерпела несколько изменений, извлеките с сервера версию всех связанных элементов в виде даты и времени создания набора изменений.
Чтобы восстановить отложенное изменение другого пользователя, добавьте имя этого пользователя к имени набора отложенных изменений. Однако для удаления набора отложенных изменений, созданного другим пользователем, из Team Foundation Server требуется разрешение "AdminShelvedChangesets".
Если предпринимается попытка восстановления элемента, для которого в конечной рабочей области существует ожидающее изменение, Team Foundation не объединит отличия элементов и не извлечет изменение в рабочую область.
Удалить набор отложенных изменений можно с помощью команды tf shelve /delete. Дополнительные сведения см. в разделе Команда "shelve". Чтобы автоматически удалить набор отложенных изменений после восстановления всего набора отложенных изменений, воспользуйтесь командой tf unshelve /move.
Примеры
В следующем примере открывается диалоговое окно Восстановить из набора отложенных изменений, в котором можно найти и восстановить набор отложенных изменений в рабочую область. В этом диалоговом окне находится параметр, предназначенный для удаления набора отложенных изменений по завершении операции восстановления из набора отложенных изменений.
c:\>tf unshelve
В следующем примере выполняется восстановление набора отложенных изменений "buddytest_1256" в текущую рабочую область и его удаление из Team Foundation Server.
c:\>tf unshelve /move buddytest_1256
См. также
Задачи
Пошаговое руководство. Дополнительные функциональные возможности системы управления версиями
Практическое руководство. Включение в набор и восстановление ожидающих изменений
Основные понятия
Работа с наборами отложенных изменений системы управления версиями
Ссылки
Синтаксис командной строки (Team System)