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


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

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

Visual Studio 2019 | Visual Studio 2022

Команда система управления версиями Team Foundation (TFVC) rename изменяет имя или путь к файлу или папке. Вы можете использовать rename команду или псевдонимы move или renпереместить файл или папку в новое расположение.

Примечание.

Результаты этой команды не отражаются на сервере, пока вы не сделаете проверка-в. Дополнительные сведения см. в разделе "Разработка кода" и управление ожидающих изменений.

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

Чтобы использовать rename команду, необходимо иметь для параметра "Разрешить" разрешение "Проверить". Дополнительные сведения см. в разделе "Разрешения TFVC по умолчанию".

Синтаксис

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

Параметры

Аргументы

Argument

Description

<olditem>

Исходное имя и путь к файлу или папке, которые необходимо переименовать. Вы можете указать путь к локальной рабочей области, например C:\myfiles\314.cs или ПУТЬ к серверу TFVC, например $/myfiles/314.cs.

<newitem>

Новое имя файла или папки. Это можно использовать для указания другого локального или расположения пути к серверу TFVC.

<username>

Предоставляет значение /login для параметра. Можно указать значение имени пользователя как DOMAIN\username или username.

Параметры

Параметр

Description

/lock

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

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

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

/login

Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps.

Замечания

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

rename Используйте команду для выполнения следующих действий:

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

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

Невозможно переименовать элемент, если:

  • Вы уже удалили его, прежде чем он был проверка в той же рабочей области.
  • Новое имя уже существует на сервере TFVC и не является папкой.
  • Вы уже добавили, ветвление или переименовали ожидающий проверка элемента.
  • Элемент сопоставляется в рабочей области, но недоступен на локальном диске.
  • Элемент закрыт.

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

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

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

Примеры

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

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

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

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

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

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