Команда unshelve (система управления версиями Team Foundation)

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

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

Необходимые компоненты

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

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

Синтаксис

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

Параметры

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

Аргументы

Argument

Description

<shelveset-name>

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

<owner-name>

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

<item-spec>

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

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

Примечание.

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

<username>

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

<password>

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

Параметры

Параметр

Description

/move

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

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

/recursive

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

/noprompt

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

/login

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

Замечания

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

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

c:\>tf unshelve

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

c:\>tf unshelve /move buddytest_1256