Команда "undelete"

Обновлен: Ноябрь 2007

Команда undelete восстанавливает ранее удаленные элементы.

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

Требуемые разрешения

Для использования команды undelete необходимо иметь разрешение Извлечение со значением Разрешить. При применении параметра /lock со значением, отличным от "none", необходимо иметь разрешение Блокировка со значением Разрешить. Кроме того, необходимо являться владельцем рабочей области или иметь глобальное разрешение Администрирование рабочих областей со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

tf undelete [/noget] [/lock:(none|checkin|checkout)] [/newname:name] 
[/recursive] itemspec[;deletionID]

Параметры

Аргумент	Описание
name	Предоставляемое пользователем значение параметра /newname. Можно указывать локальный путь или путь к серверу.
itemspec	Определяет файл или папку для восстановления. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Синтаксис командной строки (Team System).
deletionID	Задает уникальный идентификатор, устраняющий неоднозначность нескольких удаленных элементов с одинаковыми именами.

Параметр	Описание
/noget	Восстанавливает удаленный элемент в рабочей области и затем, отложив выполнение операции возврата, восстанавливает элемент на сервере, но не сразу извлекает его физическую копию на диск.
/lock	Запрещает извлечение и возврат указанных файлов другими пользователями. Дополнительные сведения см. в разделе Основные сведения о типах блокировки. Параметры блокировки None Значение по умолчанию. Блокировка не применяется. Checkin Другие пользователи могут извлекать указанные элементы, но не могут возвращать исправления в заблокированные файлы до отмены блокировки с помощью операции возврата. Если какой-нибудь другой пользователь уже заблокировал один из заданных элементов, операция блокировки завершается неудачей. Checkout Запрещает другим пользователям возвращать или извлекать указанные элементы до отмены блокировки с помощью операции возврата. Если какой-нибудь другой пользователь уже заблокировал один из заданных элементов, операция блокировки завершается неудачей.
/newname	Переименовывает элемент при восстановлении.
/recursive	Восстанавливает все файлы и вложенные папки в указанном каталоге.

Заметки

Команда "undelete" и программа командной строки "tf" планирует восстановление заданных файлов или папок, при этом выполнение операции возврата откладывается. Она также извлекает заданные элементы с сервера на локальный диск вплоть до явного использования параметра /noget.

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

Чтобы восстановить элемент в папку сервера, где элемент с таким именем уже существует или является отложенным добавлением, следует использовать параметр /newname для присвоения восстанавливаемому элементу нового имени. Восстанавливать элементы с помощью параметра /newname можно только по одному.

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

Когда itemspec задает папку, Team Foundation по умолчанию восстанавливает все ее файлы и вложенные папки с файлами. Если не требуется восстанавливать все элементы в папке, сначала нужно восстановить папку и ее элементы, а затем удалить ненужные.

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

Примеры

В следующем примере файл "314.cs" восстанавливается в папку сервера, из которой он был удален, и в текущей рабочей области извлекается копия последней версии только для чтения.

C:\projects>tf undelete c:\math\314.cs

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

c:\projects>tf dir $/ /deleted

• Пример результатов выполнения

  $/projects/math/314.cs;X10
  $/projects/math/314.cs;X11
  

В следующем примере версия X11 файла "314.cs" восстанавливается в папку сервера, из которой файл был удален, и в текущей рабочей области извлекается копия последней версии только для чтения.

c:\projects>tf undelete 314.cs;X11

См. также

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

Ожидающие изменения

Основные сведения о типах блокировки

Ссылки

Синтаксис командной строки (Team System)

Команда "rename" (Управление версиями Team Foundation)

Команда "delete"

Команда "dir"

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

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