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

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

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

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

Если вы хотите использовать shelve команду для удаления набора полок, необходимо быть владельцем набора полок или разрешением Администратор ister на изменения должны иметь значение Allow. Дополнительные сведения см. в разделе "Разрешения TFVC по умолчанию".

Синтаксис

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]

Параметры

Аргументы

Argument Description
<commentfile> Указывает путь к файловой системе файла, из которого следует читать примечания для набора полок.
<comment> Указывает комментарий для набора полок.
<itemspec> Определяет файлы или папки для отложения. По умолчанию все ожидающие изменения в текущей рабочей области будут отложены, если этот параметр не указан. Дополнительные сведения о том, как Team Foundation анализирует itemspec элементы, находящиеся в область, см. в разделе "Использование параметров для изменения функций команд".
<shelvesetname> Указывает имя, с помощью которого набор полок можно получить с сервера Azure DevOps. Можно указать существующее сочетание shelvesetname , ownerно только в том случае, если /replace он также указан.

Необходимо указать значение для этого параметра.
<owner> Определяет текущего или предполагаемого владельца набора по имени пользователя. По умолчанию текущий пользователь назначает владение набором полок, если он не указан.
<username> Предоставляет значение /login для параметра. Можно указать значение имени пользователя как DOMAIN\username или username.
<TeamProjectCollectionUrl> URL-адрес коллекции проектов, содержащей файлы или папки, которые требуется отложить, например http://myserver:8080/tfs/DefaultCollection/.

Параметры

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

Замечания

Команда shelvetf служебной программы командной строки создает резервные копии ожидающих изменений, список связанных рабочих элементов, выполняемых проверка заметки и примечания в наборе полок на сервере Azure DevOps. Набор полок очень похож на набор изменений, который не фиксируется на сервере. Как и набор изменений, набор полок можно получить с сервера в локальную рабочую область любым пользователем, имеющим достаточные разрешения.

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

  • Предоставление общего доступа к набору локальных рабочих файлов другому разработчику или тестировщику без проверка изменений на сервере управления версиями.

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

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

  • Используется Undo для отмены изменений, которые были отложены. Файлы, ожидающие добавления, удаляются из рабочей области.

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

  • Помечает все элементы в текущей рабочей области только для чтения.

Если включить /delete этот параметр, TFVC окончательно удаляет указанный набор полков с сервера Azure DevOps.

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

Примеры

В следующем примере создается новый набор полок на вызываемом Reflector_BuddyTestсервере Azure DevOps, который назначает пользователю Patправо владения, возвращает все элементы в текущей рабочей области в последнюю версию, скачаемую во время последней get операции, и задает состояние только для чтения:

c:\projects> tf shelve Reflector_BuddyTest;Pat /move

В следующем примере удаляется существующий набор new-feature полок с сервера, создается новый набор по имени и сохраняется все ожидающие изменения в текущей рабочей области:

c:\projects> tf shelve new-feature /replace

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

c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive

В следующем примере удаляется HelloWorld_24 набор полок:

c:\projects> tf shelve HelloWorld_24 /delete