Compartilhar via


Renomear comando (Team Foundation controle de versão)

The rename comando altera o nome ou o caminho para um arquivo ou pasta. Você pode usar o rename Os aliases ou comando 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 servidor até você executar uma operação de check-in. Para obter mais informações, consulte Como: Alterações pendentes Fazer Marcar-in.

Permissões necessárias

Para usar o rename comando, você tem a Fazer check-out permissão definido como Permitir.Para obter mais informações, consulte Permissões de Team Foundation Servidor.

tf rename [/lock:(none|checkout|checkin)] olditem newitem

Parâmetros

Argumento

Descrição

olditem

O nome original e o caminho do arquivo ou pasta que está a ser renomeado.Você pode especificar um caminho de espaço de trabalho local, sistema autônomo C:\myfiles\314.cs ou um Controle de versão do Team Foundation caminho do servidor, sistema autônomo $ / myfiles/314.cs.

NewItem

O novo nome de arquivo ou pasta.Você pode usar isso para especificar um local diferente ou um Controle de versão do Team Foundation local do caminho do servidor.

Opção

Descrição

/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 bloquear existente do item não será alterado.Para obter mais informações, consulte Noções básicas sobre tipos de Bloquear.

Opções de bloquear:

  • Nenhum   Nenhum bloquear é aplicado.

  • fazer check-in   Outros usuários podem fazer check-out de itens especificados, mas eles não podem verificar em revisões de arquivos bloqueados até que você versão bloquear executando um fazer check-in.Se outros usuários bloquearam qualquer um dos itens especificados, a operação de bloquear falhará.

  • Check-out   Impede que outros usuários de check-in ou check-out de qualquer um dos itens especificados, até você liberar o bloquear executando um check-in.Se outros usuários bloquearam qualquer um dos itens especificados, a operação de bloquear falhará.

Comentários

Você pode usar o rename comando da tf Utilitário de linha de comando para mover ou renomear um item controlado por versão da sua área de trabalho. Use o rename comando para mover vários arquivos especificando caracteres curinga. A capacidade de renomear vários arquivos com controle de versão ou pastas, só está disponível na linha de comando.

Use o Rename para fazer o seguinte:

  • Rename the olditemto the newitem, such as tf rename 314.cs 315.cs.

  • Move the olditem to a new location in the Controle de versão do Team Foundation server by providing a newitem whose path differs from that of the olditem, such as ** **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. If newitem é uma pasta olditem se torna filho do newitem.

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

  • Você já excluiu-lo antes que ele foi submetido a check-ao mesmo espaço de trabalho.

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

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

  • O item está mapeado 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 com o 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 tenha pendentes edições, as edições são preservadas.

Não é possível renomear um item explicitamente mapeado sem primeiro alterar o mapeamento.Por exemplo, se houver um mapeamento de pasta de trabalho de $ / ProjectX/MyApp para c:\MyApp, não é possível renomear MyApp.Você pode renomear itens em MyApp but not MyApp propriamente dito.

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

Exemplos

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

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

O exemplo a seguir renomeia 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 bloquear a ele.

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

Consulte também

Tarefas

Como: Mover, renomear e excluir versão-controlado por arquivos e pastas

Conceitos

Noções básicas sobre tipos de Bloquear

Alterações pendentes

Referência

Sintaxe de linha de comando (Team Sistema)

Adicionar comando

Excluir comando (Team Foundation controle de versão)

Obter comando

Outros recursos

Comandos do utilitário de linha de comando TF