Команда 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 |
Указывает коллекцию проектов. |
Замечания
Команда shelve tf служебной программы командной строки создает резервные копии ожидающих изменений, список связанных рабочих элементов, выполняемых проверка заметки и примечания в наборе полок на сервере 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