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

Команда unshelve (Team Foundation Version Control)

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Команда Team Foundation Version Control (TFVC) unshelve восстанавливает отложенные исправления файлов, заметки, комментарии и связи рабочих элементов с текущей рабочей областью. Вы также можете использовать команду unshelve для удаления существующего набора полок с сервера.

Необходимые условия

  • Чтобы использовать команду unshelve, выполните следующие действия.
    • Задайте для разрешения разрешить разрешить.
    • Укажите разрешение для элементов в наборе полок, для которых задано значение Разрешить.
  • Чтобы удалить набор полок, будьте его владельцем или укажите изменения, глобальные разрешения Allow.

Дополнительные сведения см. в разделе разрешения TFVC по умолчанию.

Синтаксис

tf unshelve [/move] [<shelveset-name>[;<owner-name>]] <item-spec> 
[/recursive] [/noprompt][/login:<username>,[<password>]]

Параметры

В следующих разделах описаны аргументы и параметры команды unshelve.

Аргументы

аргумент

описание

<shelveset-name>

Задает имя набора полок для восстановления.

<owner-name>

Указывает имя пользователя владельца набора полок.

<item-spec>

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

Дополнительные сведения о том, как TFVC анализирует <item-spec> значения, чтобы определить, какие элементы находятся в области, см. в разделе Использование команд управления версиями Team Foundation. Используйте параметры для изменения способафункций команд.

Заметка

Можно указать несколько <item-spec> аргументов.

<username>

Предоставляет значение для параметра /login. Это значение можно указать как DOMAIN\<username> или <username>.

<password>

Предоставляет значение для параметра /login.

Параметры

параметра

описание

/move

Удаляет указанный набор полков с сервера Azure DevOps после успешного отмены размещения набора полок. Этот параметр нельзя объединить со значением <item-spec>.

Вы также можете удалить набор полок с помощью команды shelve.

/recursive

Указывает, что значение <item-spec> должно соответствовать рекурсивно.

/noprompt

Указывает, что TFVC не должен запрашивать входные данные.

/login

Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps.

Замечания

Команда unshelve служебной программы командной строки tf извлекает все отложенные исправления файлов или определенное подмножество всех отложенных версий файлов с сервера Azure DevOps. Затем команда сохраняет редакции в текущей рабочей области.

Чтобы отменить удаление элемента, в целевой рабочей области не должно быть ожидающих изменений.

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

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

Дополнительные сведения об использовании служебной программы командной строки tf см. в разделе Использование команд управления версиями Team Foundation.

Изменения в корзине

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

Отмена и проверка кода другого пользователя

Вы также можете отменить набор полок, чтобы просмотреть изменения из рабочей области другого пользователя. Чтобы отменить эту причину, у вас есть два варианта:

  • Первый вариант подходит, если отложенные элементы и связанные элементы не были изменены, или были изменены только легко после создания набора полок. В этом случае можно получить базовую версию всех связанных элементов из рабочей области владельца набора полок. Чтобы использовать этот параметр, выполните вариант следующей команды: tf get \* /version;W<workspace-name>, где <workspace-name> — это имя рабочей области, из которой другой пользователь создал набор полок.

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

Вы можете отменить отложенное изменение другого пользователя, добавив имя пользователя в имя набора полок. Однако можно удалить набор полок только с сервера Azure DevOps, созданного другим пользователем, если у вас есть разрешение AdminShelvedChangesets.

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

С помощью tf shelve /deleteможно удалить набор полок. Дополнительные сведения см. в команде Shelve. Чтобы автоматически удалить набор полок после отмены всего набора полок, используйте tf unshelve /move.

Примеры

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

c:\>tf unshelve

В следующем примере распаковывается набор полков buddytest_1256 в текущую рабочую область и удаляется из Azure DevOps Server:

c:\>tf unshelve /move buddytest_1256