Команда Unshelve

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

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

Для использования команды unshelve необходимо иметь разрешение Чтение со значением Разрешить и разрешение Извлечение для элементов в наборе отложенных изменений со значением Разрешить. Кроме того, чтобы удалить набор отложенных изменений, необходимо быть его владельцем или иметь глобальное разрешение Администрирование изменений, включенных в набор отложенных изменений со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

tf unshelve [/move] [shelvesetname[;username]] itemspec 
[/recursive] [/noprompt][/login:username,[password]]

Параметры

Аргумент	Описание
shelvesetname	Имя набора отложенных изменений, которое необходимо восстановить.
ownername	Имя владельца набора отложенных изменений.
Itemspec	Определяет изменения файла или папки для восстановления из набора изменений в текущую рабочую область. Если этот параметр не используется, все ожидающие изменения в указанном наборе отложенных изменений восстанавливаются по умолчанию. Указание путей к серверу не допускается. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить какие из них находятся в области его действия, см. в разделе Параметры командной строки. Примечание Можно указать более одного аргумента Itemspec.
username	Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя.

Параметр	Описание
/move	Удаляет указанный набор отложенных изменений с сервера Team Foundation (подсистема контроля версий) после успешного выполнения операции восстановления из набора изменений. Этот параметр нельзя использовать вместе с параметром itemspec. Набор отложенных изменений можно также удалить с помощью команды shelve.
/recursive	Если параметр указан, выполняется рекурсивный поиск спецификации элемента.
/noprompt	Если параметр указан, запрос на ввод данных отображаться не будет.
/login	Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server.

Заметки

Команда 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

См. также

Задачи

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

Ссылки

Синтаксис командной строки (управление версиями)

Команда Shelve

Команда Changeset

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

Работа с наборами отложенных изменений

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

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