Compartilhar via

Referência de comandos de controle de versão do Team Foundation

  • Artigo

Você pode usar comandos de controle de versão fazer quase todas as tarefas que você pode fazer no Visual Studio, e também várias tarefas que não podem ser feitas no Visual Studio.Você pode usar a ferramenta de tf.exe para executar comandos de controle de versão de um prompt de comando ou em um script.

O que você deseja fazer?

  • Executar um comando

    • Configurar seu computador de dev

    • Desenvolver seu aplicativo

    • Suspenda seu trabalho

    • Contribua seu trabalho

    • Gerenciar arquivos e resolver problemas

    • Isole riscos

  • Entender a sintaxe de comando

  • Especifique os itens afetados por um comando

    • Use um argumento de itemspec para especificar itens afetados

    • Use um argumento de versionspec para especificar versões afetadas de itens

  • Use opções alterar como funções de comando

    • Use a opção de /noprompt suprimir solicitações para entrada de dados e redirecionar dados de saída para a janela de prompt de comando

    • Use a opção de /login especificar credenciais para executar um comando

    • Use a opção de /lock aplicar ou remover um bloqueio

    • Use atalhos de opção

  • Entenda códigos de saída

Executar um comando

Para iniciar o prompt de comando Visual Studio, Windows Iniciar, escolha Miscrosoft Visual Studio 2012, Visual Studio Tools, escolha um dos atalhos de Prompt de comando .

Na maioria dos casos, você executa o comando de controle de versão no contexto de um diretório que é mapeado no espaço de trabalho.Por exemplo, $/SiteApp/Main/ é mapeado para c:\code\SiteApp\Main\.Para obter a versão mais recente de todos os itens no espaço de trabalho:

c:\code\SiteApp\Main\SolutionA>tf get
ObservaçãoObservação

Nós não republishing atualmente os alguns dos tópicos.No entanto, você pode ler a versão do Visual Studio 2010 desses tópicos.

cc31bk2e.collapse_all(pt-br,VS.110).gifConfigurar seu computador de dev e gerencia os espaços de trabalho

Seu espaço de trabalho é uma cópia local da da sua equipe.Porque é uma cópia local no seu computador de dev, você pode desenvolver e testar seu código no isolamento até que você está pronto para fazer o check-in seu trabalho.Eis alguns comandos gerenciar seu espaço de trabalho:

Consulte também: Configurar sua máquina de desenvolvimento e começar a usar o controle de versão, Gerenciar seus espaços de trabalho

cc31bk2e.collapse_all(pt-br,VS.110).gifDesenvolver seu aplicativo

Use esses comandos desenvolver seu aplicativo sob controle de versão com sua equipe:

Consulte também: Desenvolver seu aplicativo em uma base de código controlado por versão

cc31bk2e.collapse_all(pt-br,VS.110).gifSuspenda seu trabalho

Por vários motivos, às vezes você precisará definir alguns ou todos seus trabalhos em traço.Para suspender e continuar seu trabalho, e gerenciar seus check-ins particulares, usam esses comandos:

Consulte também: Suspender seu trabalho e gerenciar seu Shelvesetscheck-ins particulares.

cc31bk2e.collapse_all(pt-br,VS.110).gifContribua seu trabalho

É aqui como fazer check-in o código para o codebase de equipe:

  • Comando Check-in
    Faça check-in de alterações para os arquivos ou pastas para o servidor.

Consulte também: Fazer check-in de seu trabalho para a base de código da equipe

cc31bk2e.collapse_all(pt-br,VS.110).gifGerenciar arquivos e resolver problemas

cc31bk2e.collapse_all(pt-br,VS.110).gifIsole riscos

Use os seguintes comandos isolar o risco usando ramificações:

Consulte também: Isolar o risco usando ramificações.

cc31bk2e.collapse_all(pt-br,VS.110).gifAdministre o controle de versão

Use os seguintes comandos administrar seu sistema de controle de versão:

Consulte também: Administrando o controle de versão Team Foundation (Visual Studio 2010).

cc31bk2e.collapse_all(pt-br,VS.110).gifObter ajuda sobre comandos de controle de versão

Use os seguintes comandos obter mais informações sobre comandos de controle de versão:

Entender a sintaxe de comando

A sintaxe de cada comando aparece na parte superior de cada tópico de referência.

cc31bk2e.collapse_all(pt-br,VS.110).gifArgumentos necessários e opcionais

Os argumentos são suportados são necessários.[Brackets] indica os argumentos opcionais que não são necessários para concluir um comando.No entanto, alguns argumentos opcionais têm padrões que são aplicadas ao comando mesmo se você não especificar a opção.

cc31bk2e.collapse_all(pt-br,VS.110).gifArgumentos exclusivos

Quando as opções são separadas por um pipe (|), você pode especificar uma das opções.

cc31bk2e.collapse_all(pt-br,VS.110).gifArgumentos textuais e substituível

Os itens em negrito são opções que você inclui verbatim.os itens deEm itálico são argumentos que você deve substituir com os caracteres reais para executar um comando.

cc31bk2e.collapse_all(pt-br,VS.110).gifAtalhos e alias de comando

Atalhos de suporte de alguns comandos.Por exemplo, você pode chamar Comando delete com tf delete ou tf del.

cc31bk2e.collapse_all(pt-br,VS.110).gifExemplo

Por exemplo, Comando check-out:

tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]

Vamos examinar os argumentos neste exemplo:

  • itemspec: Você deve substituir esse argumento com itemspec que especifica os itens que você está fazendo check-out.

  • /lock:(none|checkin|checkout): Não é necessário especificar a opção de /lock .Se você não especifica a, o sistema especifica por padrão /lock:none.Caso contrário, você pode especificar uma das opções de bloqueio.

  • Os seguintes argumentos são opcionais e se você não fornece os, nenhum de seus efeitos se aplicam ao comando:

    • /recursive: Se você deseja fazer o check-out recursivamente vários itens em uma pasta, você deve especificar esta opção verbatim.

    • /login:nome de usuáriosenha,: Se você desejar executar o comando como outro usuário, você deve especificar a opção de /login verbatim, substitui nome de usuário com o nome de usuário e, se necessário, você pode fornecer a senha.

Especifique os itens afetados por um comando

Você pode usar itemspecs e versionspecs para especificar quais itens são afetados por um comando.

cc31bk2e.collapse_all(pt-br,VS.110).gifUse um argumento de itemspec para especificar itens afetados

Você usa itemspec (especificação de item) para especificar os itens afetados por um comando.Você pode especificar itens em um computador cliente ou no Team Foundation Server.Você pode usar caracteres curinga como * e ?.

cc31bk2e.collapse_all(pt-br,VS.110).gifArgumentos de itemspec de cliente

Um argumento de itemspec de cliente especifica um caminho para os itens em um computador cliente como uma pasta (por exemplo, c:\code\SiteApp\Main\SolutionA\) um arquivo (por exemplo, c:\code\SiteApp\Main\SolutionA\Project1\program.cs ou mais arquivos (por exemplo, c:\code\SiteApp\Main\SolutionA\*.cs.Você também pode especificar caminhos UNC como \\myshare\code\SiteApp\Main.

cc31bk2e.collapse_all(pt-br,VS.110).gifArgumentos de itemspec de servidor

Um argumento de itemspec de servidor especifica um caminho para os itens em seu Team Foundation Server como uma pasta (por exemplo, $/SiteApp/Main/SolutionA) um arquivo (por exemplo, $/SiteApp/Main/SolutionA/Project1/program.cs ou mais arquivos (por exemplo, $/SiteApp/Main/SolutionA/*.cs.

Você normalmente usa argumentos de itemspec de servidor quando você precisa para executar um comando em itens não no cliente.Por exemplo, você está trabalhando em um computador de dev e precisa obter alguns dados de histórico de revisão sobre alguns itens que estão em uma coleção de projeto de equipe você não funciona em:

c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive  
/noprompt

cc31bk2e.collapse_all(pt-br,VS.110).gifVários argumentos de itemspec

Para alguns comandos, você pode especificar vários argumentos de itemspec .Por exemplo:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Fazer check-out e module.vb. program2.c.

cc31bk2e.collapse_all(pt-br,VS.110).gifUse um argumento de versionspec para especificar versões afetadas de itens

Você usa versionspec (especificação de versão) para especificar a versão dos itens afetados por um comando.Para fornecer versionspec você pode:

  • Use a opção de /version .Por exemplo: /version:C44

  • Acrescentar o versionspec a um itemspec com ponto-e-vírgula.Por exemplo: program1.cs;C44

Quando você usa Comando Histórico ou Difference Command, você pode especificar um intervalo de versões separando as versões com um til (~).Por exemplo:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

Use a seguinte sintaxe para especificar versionspec.

Tipo

Sintaxe

Descrição

Conjunto de alterações

[C]n

Especifica os itens com base no número do conjunto de alterações.Se um item que está no escopo não foi alterado no conjunto de alterações especificado, o sistema tem a versão mais recente do item que ocorreu antes do conjunto de alterações especificado.

DicaDica
Você pode omitir C se você especificar apenas um número.

Exemplos

c:\code\SiteApp\Main>tf get readme.txt /v:C8

-- ou --

c:\code\SiteApp\Main>tf get readme.txt /v:8

-- ou --

c:\code\SiteApp\Main>tf get readme.txt;8

Se readme.txt foi alterado o conjunto de alterações 8, obtém a versão do arquivo.Se não, obtém a versão mais recente de readme.txt antes de versão 8.

Label

Llabel

Especifica os itens que label foi aplicado.

Exemplos

c:\code\SiteApp\Main>tf get readme.txt;LJulyHotFix

Obtém a versão de readme.txt que foi rotulada JulyHotFix.

c:\code\SiteApp\Main>tf get /version:LLastKnownGood

Recupera a versão de todos os itens rotulados (e exclusões desses itens rotulados não) no espaço de trabalho que existiram quando o conjunto de alterações rotulado como LastKnownGood foi criado, por exemplo, talvez como parte de processo de compilação automatizado.

Data e hora

Dyyyy-mm-ddTxx:xx

- ou -

Dmm/dd/yyyy

- ou -

Qualquer formato suportado framework .NET.

- ou -

Alguns dos formatos de data suportados no computador local.

Especifica um conjunto criado em uma data e hora em especificadas.

Exemplos

c:\code\SiteApp\Main>tf get /version:D2004-03-22

Atualiza o espaço de trabalho para coincidir com o codebase como existiu em 3/22/2004 em 00:00 (meia-noite).

c:\code\SiteApp\Main>tf get /version:D2004-03-22T09:00

Atualiza o espaço de trabalho para coincidir com o codebase como existiu em 3/22/2004 no 09:00 (9 AM).

Para obter mais informações sobre formatos suportados framework .NET de data e hora consulte DateTime e Data padrão e seqüências de caracteres de formato de hora.

O espaço de trabalho (padrão)

W

Especifica a versão em seu espaço de trabalho.

O espaço de trabalho (especificado)

Wworkspacename; workspaceowner

Especifica a versão em um espaço de trabalho especificado.

Por exemplo: WResolveRIConflicts;PeterW

Dica

T

Especifica a versão mais recente.

Use opções alterar como funções de comando

Você pode usar algumas opções comum alterar como funções de comando.

cc31bk2e.collapse_all(pt-br,VS.110).gifUse a opção de /noprompt suprimir solicitações para entrada de dados e redirecionar dados de saída para a janela de prompt de comando

Use a opção de /noprompt suprimir solicitações para entrada de dados e redirecionar dados de saída para a janela do prompt de comando.Essa opção pode ser útil quando você precisa usar comandos de controle de versão em um script porque o comando continue sem a intervenção por um usuário, e os dados estão disponíveis para que o script executa operações como análise ou capturar.

Quando você usar esta opção, o sistema:

  • Suprime todas as solicitações para a entrada:

    • As perguntas não são feitas na janela do prompt de comando.Por exemplo, quando você usa Comando Desfazer com essa opção, o sistema não lhe avisa para confirmar se você deseja prosseguir com desfazer as alterações.

    • Windows e caixas de diálogo não são apresentados.Por exemplo, você usa esta opção com Comando Check-in.Em vez de exibir a caixa de diálogo Fazer Check-in que você confirme as opções (os itens que você deseja fazer o check-in ou que itens de trabalho para associar), o sistema continua com fazer check-in sem confirmação.

  • Redireciona dados de saída para o prompt de comando.Por exemplo, você usa esta opção com Comando Histórico.Os dados são exibidos na janela do prompt de comando em vez de Janela histórico.

cc31bk2e.collapse_all(pt-br,VS.110).gifUse a opção de /login especificar credenciais para executar um comando

Use a opção de /login especificar a conta de usuário do Team Foundation Server para executar um comando.Essa opção pode ser útil quando você está trabalhando no computador de outro membro da equipe.

Por exemplo, Julia está trabalhando com o Peter no seu computador de dev.Usa Comando bloqueio para desbloquear um arquivo que ele bloqueou anteriormente:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword

Se desejar evitar ter sua senha aparece no prompt de comando, pode inserir o comando sem a senha:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI

Depois que insere este comando, o sistema então solicitar-la a digite a senha em uma caixa de diálogo que mascare sua entrada.

cc31bk2e.collapse_all(pt-br,VS.110).gifUse a opção de /lock aplicar ou remover um bloqueio

Observação importanteImportante

Como prática recomendada, use a opção de /lock com critério e notifique suas colegas de equipe porque você está bloqueando um item, e quando você planeja para remover o bloqueio.

Use a opção de /lock aplicar ou para remover um bloqueio ao mesmo tempo você executar outro comando como Adicione ou Edição.

/lock:(none|checkin|checkout)

  • None: Nenhum bloqueio é colocado em um item.Se um bloqueio é já no lugar, ele é removido.

  • Checkin ou Checkout: Aplicar um bloqueio.Consulte Compreender os tipos de bloqueio.

ObservaçãoObservação

Em alguns casos, a operação de bloqueio pode falhar:

  • Se quaisquer outros usuários tiverem bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.

  • O sistema ignorar essa opção se já há uma alteração pendente ao item.Nesse caso, você deve usar Lock Command para alterar um bloqueio em um item.

cc31bk2e.collapse_all(pt-br,VS.110).gifUse atalhos de opção

Você pode abreviar as seguintes opções.

Opção

Alias de opção

/comment

-C

/computer

-M

/delete

-D

/force

-P

/format

-F

/help

-?, -H

/lock

-K

/login

-Y

/newname

-N

/noprompt

-I

/owner

-O

/recursive

-R

/server

-S

/slotmode

-X

/template

-T

/user

-U

/version

-V

/workspace

-W

Entenda códigos de saída

Os comandos de controle de versão retorna os seguintes códigos de saída:

Código de Saída

Definição

0

Êxito.

1

Êxito; parcial isso significa algo pelo menos, ou possivelmente todos, não tiver êxito.

2

Comando não reconhecido.

100

Nada foi bem-sucedida.

Por exemplo:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Se um dos arquivos que você está tentando fazer o check-out não existir no servidor, o comando retorna 1 para indicar o êxito parcial.