Comando Branch
O branch comando copia um item ou conjunto de itens, incluindo o histórico de controle de versão e os metadados, de um local para outro na Controle de versão do Team Foundation server e no espaço de trabalho local.
.gif "Observação") 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 branch de comando, você deve ter o leitura permissão para o item de origem e o Check-out e Mesclar permissões para a pasta de destino definido como Permitir. For more information, see Permissões de Team Foundation Server.
tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]]
Parâmetros
Argument |
Description |
|---|---|
olditem |
Especifica o nome do arquivo de origem ou da pasta sendo ramificado. O olditem também podem conter informações de versão no formato item;version. |
newitem |
Especifica o nome do arquivo de destino ou a pasta ou a pasta pai para o destino. Se newitem já existe e é um Controle de versão do Team Foundation a pasta de servidor, Team Foundation cria itens ramificados de proprietário. Caso contrário, newitem Especifica o nome do arquivo de destino ou da pasta. Os conflitos podem ocorrer durante o check-in, se o destino já existe. |
versionspec |
Fornece um valor 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). |
comment |
Fornece um comentário sobre a ramificação. |
@commentfile |
Especifica o caminho de um arquivo que contém o comentário que é usado para a ramificação. |
authorname |
O valor fornecido pelo usuário para o /author opção. |
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 |
|---|---|
/version |
A versão do item no qual você deseja criar a ramificação. Você pode especificar uma versão por:
Se nenhuma versão for fornecida, Team Foundation usa a seguinte lógica para decidir qual versão do item para copiar para a nova ramificação:
Se você ramifica um arquivo cuja versão de espaço de trabalho é anterior à versão mais recente no Controle de versão do Team Foundation server, o arquivo é ramificado na versão mais antiga. |
/lock |
Impede que outros usuários fazendo check-in ou check-out de itens até que você verificar sua filial pendente e alterações associadas. For more information, see Noções básicas sobre tipos de bloqueio. Opções de bloqueio:
|
/noget |
Se esta opção for especificada, as cópias locais dos arquivos e pastas em nova ramificação não são criadas no espaço de trabalho local. No entanto, cópias locais serão recuperadas na área de trabalho na próxima vez que você executar uma operação Get de recursiva. Observação
Você pode impedir que os itens, como, por exemplo, o conteúdo de uma pasta de /images, sendo recuperados para o seu espaço de trabalho durante as operações de Get e Get Latest recursiva por encobrimento de uma pasta de trabalho.For more information, see Comando workfold.
|
/noprompt |
Suprime qualquer solicita entrada do usuário. |
/silent |
Implica /noget e especifica que a saída não é gravada para a janela do Prompt de comando quando você cria uma ramificação. |
/checkin |
Cria e verifica na ramificação para o servidor em uma única operação. Esta opção não cria quaisquer alterações pendentes no espaço de trabalho local. |
/comment |
Adiciona um comentário para a nova ramificação. Esta opção é usada somente com o /checkin opção. |
/author |
Identifica o autor da nova ramificação. Esta opção é usada somente com o /checkin opção. |
Comentários
Se você especificar um caminho local como, por exemplo, c:\00101, mas não especificar um versionspec, Team Foundation usa a versão local do espaço de trabalho como base para criar a nova ramificação.
No entanto, se você especificar um caminho de servidor como, por exemplo, $/00101/*.cs e não especificar um versionspec, Team Foundation usa o mais recente Controle de versão do Team Foundation versão do servidor como base para a criação de nova ramificação em vez disso.
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 cria um arquivo de ramificação que contém a versão mais recente do espaço de trabalho do 314.cs, nomes de "314_branch" e salva-o para o diretório atual no disco e também para o Controle de versão do Team Foundation pasta do servidor para o qual ele mapas.
c:\projects>tf branch 314.cs 314_branch
O exemplo a seguir copia todos os arquivos sem edições pendentes a versão do espaço de trabalho do sistema de coordenadas de 314. do seu atual Controle de versão do Team Foundation pasta do servidor para o testdata Controle de versão do Team Foundation pasta do servidor e do diretório atual no disco para a pasta de trabalho que mapeia para o testdata Controle de versão do Team Foundation pasta do servidor.
c:\projects>tf branch C:\314.cs $/testdata
O exemplo a seguir copia todos os arquivos sem edições na versão atual do espaço de trabalho da pasta testfiles e os arquivos pendentes contém todos os itens a partir de seu Controle de versão do Team Foundation pasta do servidor para o testfiles_branch Controle de versão do Team Foundation a pasta de servidor e de c:\testfiles para a pasta local que mapeia para o testfiles_branch Controle de versão do Team Foundation pasta do servidor.
c:\projects>tf branch C:\testfiles $/testfiles_branch
O exemplo a seguir cria uma ramificação do sistema de coordenadas de 314. como ele existia no n º 4 do changeset para o arquivo. Na pasta de trabalho em disco, como na Controle de versão do Team Foundation server, um csharp_branch de arquivo intitulado ramificação é criada.
c:\projects>tf branch C:\314.cs;C4 csharp_branch
O exemplo a seguir cria uma nova ramificação do sistema de coordenadas de 314. que ela estava no 12/12/03. Na pasta de trabalho em disco como o Controle de versão do Team Foundation server, um 314_branch de arquivo intitulado ramificação é criada.
c:\projects>tf branch 314.cs;D12/12/03 314_branch
O exemplo a seguir a versão do sistema de coordenadas de 314. ao qual se ramifica "beta1" rótulo foi aplicada, nomeia "beta1branch", e o salva na pasta atual no disco, além de Controle de versão do Team Foundation pasta do servidor ao qual mapas atual do diretório.
c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch
Consulte também
Tarefas
Arquivos e pastas de ramificação
Referência
Conceitos
Trabalhando com conjuntos de alterações