Renomear um comando (Team Foundation Version Control)

O rename comando altera o nome ou o caminho de um arquivo ou pasta. Você pode usar o rename comando ou os alias move ou ren, para mover um arquivo ou pasta para um novo local.

Observação
Os resultados deste comando não são refletidos na Controle de versão do Team Foundation server até que você realize um check-in operação. For more information, see Fazer Check In em Alterações Pendentes.

Permissões necessárias

Para usar o rename de comando, você tem a Check-out permissão definida Permitir. For more information, see Permissões de Team Foundation Server.

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

Parâmetros

Argument	Description
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, por exemplo, C:\myfiles\314.cs ou Controle de versão do Team Foundation o caminho do servidor como, por exemplo, $/ myfiles/314.cs.
NewItem	O novo nome do arquivo ou pasta. Você pode usar isso para especificar um local diferente ou um Controle de versão do Team Foundation caminho de servidor local.
username	Fornece um valor para o /login opção. Você pode especificar um valor de username como domínio\nome de usuário ou nome de usuário.

Option	Description
/lock	Inclua esta opção para impedir que outros usuários fazendo check-in ou check-out de itens especificados. Se essa opção não for especificada, o status de bloqueio existentes do item não é alterado. For more information, see Noções básicas sobre tipos de bloqueio. Opções de bloqueio: Nenhum nenhum bloqueio é aplicado. Check-in outros usuários podem fazer check-out de itens especificados, mas não pode verificar em revisões de arquivos bloqueados até você liberar o bloqueio realizando um check-in. Se qualquer um dos outro usuários bloquearam a qualquer um dos itens especificados, a operação de bloqueio falhará. Check-out impede que outros usuários fazendo check-in ou check-out de qualquer um dos itens especificados, até você liberar o bloqueio realizando um check-in. Se qualquer um dos outro usuários bloquearam a qualquer um dos itens especificados, a operação de bloqueio falhará.
/login	Especifica o nome de usuário e senha para autenticar o usuário com Visual Studio Team Foundation Server.

Comentários

Você pode usar o rename comando da tf o utilitário de linha de comando para mover ou renomear um item controlado por versão no espaço de trabalho. Use o rename comando para mover vários arquivos especificando todos os caracteres curinga. A capacidade de renomear vários arquivos de controle de versão ou pastas, só está disponível a partir da linha de comando.

Use ' Renomear ' para fazer o seguinte:

• Renomear a olditem para o newitem, como tf rename 314.cs 315.cs.

• Mover o olditem para um novo local na Controle de versão do Team Foundation server fornecendo um newitem cujo caminho é diferente da olditem, como  tf rename 314.cs ..\newdir\314.cs.

Se você fornecer um newitem que especifica uma pasta inexistente, o rename comando cria a pasta de destino. Se newitem é uma pasta olditem se torna filho do newitem.

Se não é possível renomear um item:

• Você já excluiu-lo antes que ele tenha sido verificado no mesmo espaço de trabalho.

• O novo nome já existe na Controle de versão do Team Foundation server e não é uma pasta.

• Já tiver adicionado, branched ou renomeado o check-in Pendente do item.

• O item é mapeada no espaço de trabalho, mas não está disponível no disco local.

• O item é encoberto.

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

Um item que é mapeado explicitamente 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, é possível renomear MyApp. Você pode renomear itens em MyApp , mas não MyApp propriamente dito.

Para obter mais informações sobre como localizar o tf o utilitário de linha de comando, consulte Comandos do utilitário de linha de comando do TF.

Examples

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

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

O exemplo a seguir renomeia o 314.c para 1254.c e move para a pasta novo_dir.

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

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

Consulte também

Tarefas

Mover, renomear e excluir pastas e arquivos de controle de versão

Referência

Sintaxe de linha de comando (controle de versão)

Adicionar comando

Excluir um comando (Team Foundation Version Control)

Comando Get

Conceitos

Noções básicas sobre tipos de bloqueio

Alterações pendentes

Outros recursos

Comandos do utilitário de linha de comando do TF