Comando rename (Controle de Versão do Team Foundation)

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando rename no TFVC (Controle de Versão do Team Foundation) altera o nome ou o caminho de um arquivo ou pasta. Você pode usar o comando rename ou os aliases move ou ren para mover um arquivo ou pasta para um novo local.

Observação

Os resultados desse comando não são refletidos no servidor até que você faça um check-in. Para obter mais informações, consulte Desenvolver código e gerenciar alterações pendentes.

Pré-requisitos

Para usar o comando rename, você deve ter a permissão Check-out definida como Permitir. Para saber mais, confira Permissões padrão do TFVC.

Sintaxe

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

Parâmetros

Argumentos

Argument

Descrição

<olditem>

O nome original e o caminho do arquivo ou pasta a ser renomeado. Você pode especificar um caminho de workspace local, como C:\myfiles\314.cs ou um caminho de servidor TFVC, como $/myfiles/314.cs.

<newitem>

O nome do arquivo ou da pasta. Você pode usar isso para especificar um local diferente ou um local de caminho do servidor TFVC.

<username>

Mostra um valor para a opção /login. Você pode especificar um valor de nome de usuário como DOMAIN\username ou username.

Opções

Opção

Descrição

/lock

Inclua essa opção para impedir que outros usuários entrem ou confiram os itens especificados. Se essa opção não for especificada, o status de bloqueio existente do item não será alterado. Para obter mais informações, consulte Noções básicas sobre tipos de bloqueio.

Opções de bloqueio:

  • None: nenhum bloqueio é aplicado.
  • Checkin: outros usuários podem fazer check-out dos itens especificados, mas não podem fazer check-in de revisões para arquivos bloqueados até que você libere o bloqueio fazendo um check-in. Se outros usuários tiverem bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.
  • Checkout: essa opção impede que outros usuários faça check-in ou check-out de qualquer um dos itens especificados até que você libere o bloqueio verificando os arquivos bloqueados. Se outros usuários tiverem bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.

/login

Especifica o nome de usuário e a senha para autenticar o usuário no Azure DevOps.

Comentários

Você pode usar o comando rename do utilitário de linha de comando tf para mover ou renomear um item controlado por versão em seu workspace. Use o comando rename para mover vários arquivos especificando caracteres curinga. A capacidade de renomear vários arquivos ou pastas controlados por versão só está disponível na linha de comando.

Use o comando rename para executar as seguintes ações:

  • Renomeie para olditem o newitem, como tf rename 314.cs 315.cs.
  • Mova o olditem para um novo local no servidor TFVC fornecendo um newitem, cujo caminho difere do olditem, como tf rename 314.cs ..\newdir\314.cs.

Se você fornecer uma newitem que especifique uma pasta inexistente, o comando rename criará a pasta de destino. Se newitem for uma pasta, olditem torna-se um filho de newitem.

Você não poderá renomear um item se:

  • Você já o excluiu antes de fazer check-in no mesmo workspace.
  • O novo nome já existe no servidor TFVC e não é uma pasta.
  • Você já adicionou, ramificou ou renomeou o check-in pendente do item.
  • O item é mapeado no workspace, mas não está disponível no disco local.
  • O item está camuflado.

Você pode renomear um item para o qual outro arquivo com o mesmo nome foi adicionado ao check-in pendente, mas não é possível renomear um item que foi ramificado, mas ainda não fez check-in. Quando você renomeia um arquivo que tem edições pendentes, as edições são preservadas.

Um item que é explicitamente mapeado não pode ser renomeado sem alterar primeiro o mapeamento. Por exemplo, se houver um mapeamento de pasta de trabalho de $/ProjectX/MyApp para c:\MyApp, você não poderá renomear MyApp. Você pode renomear itens sob o MyApp, mas não no próprio MyApp.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.

Exemplos

O exemplo a seguir altera o nome de 314.cs para 1254.cs.

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

O exemplo a seguir renomeia 314.cs para 1254.cs e o move para a pasta newdir.

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

O exemplo a seguir altera o nome do Form1.vb para MainPage.vb e aplica um bloqueio a ele.

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