Команда 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 |
Выберите этот параметр, чтобы предотвратить возвращение и извлечение заданных элементов другими пользователями. Если этот параметр не указан, текущее состояние блокировки элемента не изменяется. Дополнительные сведения см. в разделе Основные сведения о типах блокировки. Параметры блокировки
|
/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
См. также
Задачи
Перемещение, переименование и удаление файлов и папок в системе управления версиями
Ссылки
Синтаксис командной строки (управление версиями)
Команда Delete (управление версиями в Team Foundation)
Основные понятия
Основные сведения о типах блокировки