Partilhar via


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

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando Team Foundation Version Control (TFVC) rename altera o nome ou o caminho de um arquivo ou pasta. Você pode usar o rename comando, ou os aliases move ou ren, para mover um arquivo ou pasta para um novo local.

Nota

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 rename comando, você deve ter a permissão Check-out definida como Permitir. Para obter mais informações, consulte Permissões TFVC padrão.

Sintaxe

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

Parâmetros

Argumentos

Argumento

Descrição

<olditem>

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

<newitem>

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

<username>

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

Opções

Opção

Descrição

/lock

Inclua essa opção para impedir que outros usuários façam check-in ou check-out dos 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 Compreender os 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 de arquivos bloqueados até que você libere o bloqueio fazendo um check-in. Se qualquer outro usuário tiver bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.
  • Checkout: Impede que outros usuários façam check-in ou check-out de qualquer um dos itens especificados até que você libere o bloqueio fazendo um check-in. Se qualquer outro usuário tiver 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 com o Azure DevOps.

Observações

Você pode usar o rename comando do tf utilitário de linha de comando para mover ou renomear um item com controle de versão em seu espaço de trabalho. Use o comando para mover vários arquivos especificando caracteres curinga rename . A capacidade de renomear vários arquivos ou pastas com controle de versão está disponível somente na linha de comando.

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

  • Renomeie o olditem para , newitemcomo 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 especifica uma pasta inexistente, o rename comando criará a pasta de destino. Se newitem for uma pasta, olditem torna-se filho do newitem.

Não é possível renomear um item se:

  • Você já o excluiu antes do check-in no mesmo espaço de trabalho.
  • 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 espaço de trabalho, 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 pendente de check-in, mas não pode renomear um item que foi ramificado, mas ainda não fez check-in. Quando você renomeia um arquivo com edições pendentes, as edições são preservadas.

Um item explicitamente mapeado não pode ser renomeado sem primeiro alterar 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 em MyApp, mas não MyApp em si.

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

Exemplos

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

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

O exemplo a seguir renomeia 314.cs para 1254.cs e move-o 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