Comando Mesclar

O merge comando aplica alterações de um branch para outro.

ObservaçãoObservaçã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 merge de comando, você deve ter o Check-out permissão definida Permitir para a pasta de trabalho que contém o destino e você deve ter o leitura permissão definida Permitir para a pasta de trabalho que contém a fonte. For more information, see Permissões de Team Foundation Server.

tf merge [/recursive] [/force] [/candidate] [/discard] 
[/version:versionspec] [/lock:none|checkin|checkout] [/preview] 
[/baseless] [/nosummary] [/noimplicitbaseless] [/conservative] [/format:(brief|detailed)] [/noprompt] [/login:username,[password]] source destination

Parâmetros

Argument

Description

versionspec

Fornece um valor como o C2 para o /version opção. Para obter mais informações sobre como Team Foundation analisa uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Sintaxe de linha de comando (controle de versão).

source

Especifica o arquivo ou pasta para atuar como a origem da mesclagem.

destination

Especifica o arquivo ou pasta para atuar como o destino da mesclagem.

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

/recursive

Corresponde a source a especificação de item no diretório atual e subpastas.

/force

Ignora o histórico de mesclagem e mescla as alterações especificadas da origem o destino, mesmo se algumas ou todas essas alterações foram mescladas antes.

/candidate

Imprime uma lista de conjuntos de todas as alterações na fonte de que ainda não foram mescladas em destino. A lista deve incluir a identificação de conjunto de alterações não foi mescladas e outras informações básicas sobre esse conjunto de alterações.

/discard

Não realiza a operação de mesclagem, mas atualiza o histórico de mesclagem para controlar o que ocorreu de mala direta. Isso descarta um changeset sejam usados para uma mesclagem específica.

/version

Para uma mesclagem seletiva, esta opção especifica o intervalo que deve ser mesclado no destino. Para uma mesclagem de catch-up, este parâmetro especifica a versão antes da qual todas as alterações un-merged devem ser mescladas.

Para uma mesclagem seletiva, o intervalo de versão indica os pontos inicial e final do conjunto de alterações a serem mescladas. Por exemplo, se você tentar mesclar a versão 4 ~ 6, conjuntos de alterações, 4, 5 e 6 são mesclados.

/lock

Especifica o tipo de bloqueio ou remove um bloqueio de um item. For more information, see Noções básicas sobre tipos de bloqueio.

Opções de bloqueio:

  • None

    Nenhum bloqueio é colocado em um item e remove qualquer bloqueio existente um item.

  • Checkin

    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 usuários fazendo check-in ou check-out de qualquer um dos itens especificados, até que você explicitamente libera o bloqueio. Se outros usuários bloquearam qualquer um dos itens especificados, ou se existem alterações contra qualquer item pendentes, a operação de bloqueio falhará.

/preview

Mostra uma visualização da mesclagem.

/baseless

Executa uma mala direta sem uma versão base. Ou seja, permite que o usuário possa mesclar arquivos e pastas que não têm uma relação de mesclagem. Depois de uma mesclagem de baseless, existe uma relação de mesclagem e mesclagens futuras não precisam ser baseless.

ObservaçãoObservação
Mesclagens de baseless não podem excluir arquivos no destino.Você pode executar manualmente a sobre tais alterações.

/noimplicitbaseless

Especifica que Team Foundation não executará uma mesclagem baseless implícita entre dois itens que têm o mesmo nome relativo em duas árvores de controle de versão não relacionado.

/nosummary

Omite o resumo de conflitos, erros e avisos.

/noprompt

Suprime qualquer solicita entrada do usuário.

/conservative

Resulta em mais conflitos quando você mescla uma ramificação para outra.

/format

Especifica os formatos de resumir os conflitos de mesclagem:

  • Brief: valor padrão, se resume apenas o número total de erros, conflitos e avisos.

  • Detailed: resume não apenas o número total de erros, conflitos e avisos, mas também lista detalhes sobre cada conflito.

Nota esta opção se aplica somente quando a saída contém um resumo de conflitos. O resumo não pode ser mostrado se o /nosummary opção é usada ou a mesclagem causou menos de 10 conflitos, avisos e erros.

/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 merge comando da tf o utilitário de linha de comando para aplicar as alterações em uma ramificação de origem existente para uma ramificação de destino existente. Você pode mesclar uma revisão individual ou um changeset completo para a ramificação de destino. Você pode mesclar alterações a partir de origem para a ramificação de destino ou o destino para a ramificação de origem.

O merge comando permite também a consulta para alterações em uma ramificação de origem que não tenham sido migrados para a ramificação de destino. Além disso, ele permite que você indicar que determinadas alterações nunca serão mescladas da origem para o destino e não devem ser exibidas como candidatos para uma operação de mesclagem.

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.

Baseless Merge

Use baseless mala direta para mesclar itens que não são diretamente branched uns dos outros. Para executar uma mesclagem de baseless, você deve usar o tf merge comando. Quando você executa uma mesclagem de baseless, Team Foundation não tem nenhuma informação sobre a relação dos arquivos no braches. Em uma mesclagem de baseless, você deve executar as resoluções de conflitos manual. Depois de executada a mesclagem baseless e resolvidos os conflitos, Team Foundation registra o histórico de mesclagem e estabelece um relacionamento entre as pastas e arquivos.

Quando você executa o tf merge, Team Foundation executa uma mesclagem baseless implícita entre os itens que possuem o mesmo nome relativo em dois relacionados anteriormente controlado por versão árvores. Por exemplo, convém mesclar as ramificações relacionadas $SRC\ e $ TGT. Ambas as ramificações contém um arquivo relacionado chamado a.txt. Quando você executa o tf merge, Team Foundation estabelece um relacionamento entre os dois arquivos de a.txt se os dois arquivos forem iguais, se criptografia compatíveis com FIPS for desabilitada, e se o arquivo de origem não está relacionado a qualquer outro arquivo no destino.

Se você executar o tf merge com o /noimplicitbaseless opção definida, quando Team Foundation tenta mesclar duas ramificações, os arquivos de duas a.txt criará um conflito de namespace ao tentar fazer check-in de alterações. Para resolver o conflito, você deve renomear um dos arquivos.

Examples

O exemplo a seguir mescla alterações de MyFile_beta1 que não foram mescladas em MyFile_RTM.

c:\projects>tf merge MyFile_beta1 MyFile_RTM /recursive

O exemplo a seguir mescla changeset 137 branch2.

c:\projects>tf merge /version:C137~C137 branch1 branch2 /recursive

O exemplo a seguir mescla todos os conjuntos de alterações até changeset 137 branch2.

c:\projects>tf merge /version:C137 branch1 branch2 /recursive

O exemplo a seguir imprime uma lista os changesets em branch1 não foram mescladas em branch2.

c:\projects>tf merge /candidate branch1 branch2 /recursive

O exemplo a seguir imprime uma lista de conjuntos de alterações na branch2 que não foram mescladas novamente em branch1.

c:\projects>tf merge /candidate branch2 branch1 /recursive

O exemplo a seguir descarta changeset 137 como um candidato para mesclar em branch2.

c:\projects>tf merge /discard /version:C137 branch1 branch2 /recursive

Consulte também

Tarefas

Resolver conflitos entre dois arquivos

Referência

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

Comando Branch

Comando de mesclagens

Outros recursos

Comandos do utilitário de linha de comando do TF

Ramificação e mesclagem