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


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

Команда rename изменяет имя файла или папки или путь к ним. Команда rename или псевдонимы move или ren используются для перемещения папки в новое расположение.

Примечание

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

Необходимые разрешения

Для использования команды rename необходимо иметь разрешение Извлечение со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

Параметры

Аргумент

Описание

старый_объект

Исходное имя и путь файла или папки, которые нужно изменить. Можно задать путь локальной рабочей области, например, C:\myfiles\314.cs, или путь сервера Team Foundation (подсистема контроля версий), например $/myfiles/314.cs.

новый_объект

Новое имя файла или папки. Используется для указания другого локального расположения или расположении пути сервера Team Foundation (подсистема контроля версий).

имя пользователя

Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя.

Параметр

Описание

/lock

Выберите этот параметр, чтобы предотвратить возвращение и извлечение заданных элементов другими пользователями. Если этот параметр не указан, текущее состояние блокировки элемента не изменяется. Дополнительные сведения см. в разделе Основные сведения о типах блокировки.

Параметры блокировки

  • None    Блокировка не применяется.

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

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

/login

Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server.

Заметки

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

С помощью команды "rename" можно выполнить следующие задачи.

  • Переименовать olditem в newitem, например tf rename 314.cs 315.cs.

  • Переместить olditem в новое расположение на сервере Team Foundation (подсистема контроля версий), указав newitem, путь которого отличается от пути olditem, например  tf rename 314.cs ..\newdir\314.cs.

Если задать newitem, указывающий несуществующую папку, команда rename создаст конечную папку. Если newitem является папкой, olditem становится дочерним элементом newitem.

Далее перечислены случаи, в которых элемент не может быть переименован.

  • Элемент был удален до возврата в ту же рабочую область.

  • Новое имя уже существует на сервере Team Foundation (подсистема контроля версий) и не является папкой.

  • Отложенный возврат элемента уже был добавлен, разветвлен или переименован.

  • Элемент отображается в рабочей области, но недоступен на локальном диске.

  • Элемент замаскирован

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

Чтобы переименовать явно сопоставленный элемент, сначала требуется изменить сопоставление. Например, если существует сопоставление рабочей папки $/ProjectX/MyApp с c:\MyApp, переименовать MyApp нельзя. Можно переименовать элементы папки MyApp, но не саму папку MyApp.

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

Примеры

В следующем примере имя файла 314.c изменяется на 1254.c.

c:\projects>tf rename  314.c  1254.c

В следующем примере файл 314.c переименовывается в файл 1254.c. и перемещается в папку "newdir".

c:\projects>tf rename 314.c ..\newdir\1254.c

В следующем примере имя "Form1.vb" изменяется на "MainPage.vb" и блокируется.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin

См. также

Задачи

Перемещение, переименование и удаление файлов и папок в системе управления версиями

Ссылки

Синтаксис командной строки (управление версиями)

Команда Add

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

Команда Get

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

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

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

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

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