Comando Obter

Artigo
06/09/2015

Obtém (downloads) a versão mais recente ou uma versão específica de um ou mais arquivos ou pastas do Team Foundation Server ao espaço de trabalho. Embora o comando de Get fornece uma interface do usuário diferente do que o Visual Studio (consulte Baixar arquivos (get) do servidor), o processo é fundamentalmente o mesmo.

Requisitos: Consulta Referência de permissões para o Team Foundation Server.

tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]

Parâmetros

Parâmetro	Descrição
/all	Se você usar o espaço de trabalho local (recomendado), então 'o s improvável você precisará usar esta opção. Você pode usar esta opção para restaurar um item que você exclua de acidentalmente um espaço de trabalho do servidor. O Team Foundation Server mantém um registro interno de todos os itens que o espaço de trabalho contém, incluindo a versão de cada um. Por padrão, quando você obter arquivos, se o registro interno no servidor indica que o espaço de trabalho já tem a versão você estiver obtendo, então não recupera o item. Esta opção obtém os itens dos dados contidos nesse registro interno.
/force	Combina /all e /overwrite.
itemspec	Especifica o escopo de itens para obter. Você pode especificar mais de um argumento de itemspec . Se nenhum itemspec é fornecido, o sistema obtém recursivamente todos os itens no espaço de trabalho atual. Para a sintaxe, consulte Referência de comandos de controle de versão do Team Foundation.
/login:username,[password]	Especifica a conta de usuário para executar o comando. Consulte Referência de comandos de controle de versão do Team Foundation.
/noautoresolve	Por padrão, o sistema tenta automaticamente a Resolver Tudo Automaticamente (consulte Resolver conflitos de controle de versão do Team Foundation). Especificar esta opção desativar esse comportamento padrão.
/noprompt	Suprime a exibição das janelas e caixas de diálogo e redireciona dados de saída para o prompt de comando. Consulte Referência de comandos de controle de versão do Team Foundation.
/overwrite	Se você usar o espaço de trabalho local (recomendado), então é improvável você precisará usar esta opção. Por padrão, o sistema não recupera um item se é modificável (isto é, se o atributo somente leitura está desmarcado) no cliente. Esta opção substituir o comportamento padrão e substitui um item modificável, a menos que o item é feito o check-out.
/preview	Exibe o que ocorreria, sem realmente execute a operação de Get .
/recursive	Obtém recursivamente itens no diretório especificado e em todos os subdiretórios. Se você não especificar itemspec, então esta opção está incluída.
/remap	Consulte blog de phkelley: os tf get /remap.
/version:versionspec	Especifica a versão máximo, ou as versões mínimo e máximo, para exibir os dados do histórico. O padrão é /version:T (a versão mais recente). Para a sintaxe, consulte Referência de comandos de controle de versão do Team Foundation.

Exemplos

Em todos os exemplos, suponha que $/SiteApp/Main/ é mapeado para c:\code\SiteApp\Main\ no espaço de trabalho.

Obter a versão mais recente de todos os itens em um espaço de trabalho

c:\code\SiteApp\Main\SolutionA>tf get

Obtém as versões mais recentes de todos os itens no espaço de trabalho. Por exemplo, o comando anterior obteria recursivamente todos os arquivos em $/SiteApp/Main/ que inclui todas as suas pastas filho.

Recursivamente obter a versão mais recente dos itens de um certo em uma pasta

c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive

Obtém a versão mais recente de todos os arquivos C# (.cs) em c:\code\SiteApp\Main\SolutionA\Project1.

Obter a versão mais recente de um arquivo

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs

Obtém a versão mais recente de module.vb em Project.

Obter uma versão específica de um arquivo

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8

Obtém a versão 8 de module.vb em Project.

Obter a versão mais recente de dois arquivos

c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs

Obtém a versão mais recente de file1.cs e de file2.cs em Project.

Sincronizar um espaço de trabalho para comparar uma versão da de equipe

c:\code\SiteApp\Main>tf get /v:15

Sincroniza o espaço de trabalho para coincidir com o codebase como existiu quando o conjunto de alterações 15 foi criado:

O nome e o conteúdo de cada item no espaço de trabalho são alterados para corresponder ao estado que estava no servidor.
Itens que foram excluídos depois que o conjunto de alterações é restaurado ao espaço de trabalho.
Itens que foram adicionados depois que o conjunto de alterações é excluído do espaço de trabalho.

Sincronizar um espaço de trabalho para comparar uma versão do rótulo da equipe

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

Sincroniza o espaço de trabalho para coincidir com os itens na rotulado que são LastKnownGood:

O nome e o conteúdo de cada item rotulado no espaço de trabalho são alterados para corresponder ao estado que estava no servidor.
Os itens rotulados que foram excluídos são restaurados o espaço de trabalho.
Itens que não são rotuladas no servidor são excluídos do espaço de trabalho.

Trabalho no Visual Studio

O uso do Visual StudioBaixar arquivos (get) do servidor obtém a arquivos e pastas.

Dicas

Se você estiver começando uma nova tarefa, provavelmente é uma boa ideia para que você execute tf get (você pode fazer isso de qualquer pasta no seu espaço de trabalho) para baixar os arquivos mais recentes do servidor antes de fazer o check-out de arquivos e iniciar seu trabalho.
Quando necessário, este comando cria pastas no disco para conter os itens filhos que o comando está fazendo.
Você pode exibir informações sobre o histórico de um item usando Comando Histórico e Changeset Command.
Se você estiver preocupado sobre alterações que podem ocorrer em arquivos no espaço de trabalho, você pode usar a opção de /preview ver as alterações que ocorreriam sem realmente implementá-las.
Conflitos podem bloquear o seu obtém. Uma causa comum de conflitos está tentando obter um item em que você tenha alterações pendentes. Você pode usar Resolve Command para resolver esses conflitos.