Comando Get (Controle de Versão do Team Foundation)

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando Controle de versão do Team Foundation (TFVC) get obtém ou baixa a versão mais recente ou uma versão especificada de um ou mais arquivos ou pastas de Azure DevOps Server para o espaço de trabalho. O comando tf get apresenta uma interface do usuário diferente do Visual Studio, mas o processo é fundamentalmente o mesmo. Para mais informações sobre como usar o Visual Studio para obter arquivos e pastas, consulte Baixar (get) arquivos do servidor.

Pré-requisitos

Confira Permissões TFVC padrão.

Sintaxe

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

Parâmetros

Parâmetro

Descrição

/all

Você pode usar essa opção para restaurar um item excluído acidentalmente de um espaço de trabalho do servidor. Se você usar um espaço de trabalho local, o que é recomendado, é pouco provável que você precise usar essa opção.

O TFVC 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ê obtém arquivos, se o registro interno no servidor indicar que o espaço de trabalho já tem a versão recebida, ele não recupera o item. Essa opção obtém todos os itens, independentemente dos dados contidos no registro interno.

/force

Combina /all e /overwrite.

<itemspec>

Especifica o escopo dos itens a serem obtidos. Você pode especificar mais de um argumento itemspec. Se não itemspec for fornecido, o sistema obterá repetidamente todos os itens no espaço de trabalho atual.

Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation.

/login <username>,[<password>]

Especifica a conta de usuário na qual executar o comando. Consulte Usar comandos de controle de versão do Team Foundation.

/noautoresolve

Por padrão o sistema tenta Resolver automaticamente todos os conflitos. Para obter mais informações, consulte Resolver conflitos de controle de versão do Team Foundation. Especifique essa opção para desabilitar esse comportamento padrão.

/noprompt

Suprime a exibição de janelas e caixas de diálogo do Visual Studio e redireciona os dados de saída para o prompt de comando. Consulte Usar comandos de controle de versão do Team Foundation.

/overwrite

Por padrão, o sistema não recupera um item se ele for gravável, ou seja, seu atributo somente leitura for limpo, no computador do cliente. Essa opção substitui o comportamento padrão e substitui um item gravável, a menos que o item esteja com check-out. Se você usar um espaço de trabalho local conforme recomendado, é pouco provável que você precise usar essa opção.

/preview

Exibe o que ocorreria, sem realmente executar a operação get.

/recursive

Verifica repetidamente os itens no diretório especificado e quaisquer subdiretórios. Se você não especificar um itemspec, essa opção estará implícita.

/remap

Confira o blog de Phkelley: tf get /remap.

/version:<versionspec>

Especifica a versão máxima, ou as versões mínima e máxima, a serem exibidas nos dados do histórico. O padrão é /version:T, a última versão.

Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation.

Comentários

  • Se você estiver iniciando uma nova tarefa, é recomendado executar tf get o download dos arquivos mais recentes do servidor antes de fazer check-out de arquivos e iniciar seu trabalho. Você pode executar tf get de qualquer pasta em seu espaço de trabalho.

  • Conforme necessário, tf get cria pastas no disco para conter os itens filho que o comando baixa.

  • Você pode exibir informações sobre o histórico de um item usando o comando Histórico e o comando Conjunto de alterações.

  • Se você estiver preocupado com quais alterações podem ocorrer nos arquivos no espaço de trabalho, é possível usar a opção /preview para ver as alterações que ocorreriam sem realmente implementá-las.

  • Conflitos podem bloquear seu get. Uma causa típica de conflitos é tentar obter um item no qual você tem alterações pendentes. Você pode usar o comando Resolver para solucionar esses conflitos.

Exemplos

Os exemplos a seguir pressupõem que $/SiteApp/Main/ mapeia c:\code\SiteApp\Main\ no espaço de trabalho.

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

Por padrão, o comando tf get obtém as versões mais recentes de todos os itens no espaço de trabalho. Por exemplo, o comando a seguir obtém repetidamente todos os arquivos em $/SiteApp/Main/, incluindo todas as suas pastas filho.

c:\code\SiteApp\Main>tf get

Obter repetidamente a versão mais recente de itens de um determinado tipo em uma pasta

O exemplo a seguir obtém a versão mais recente de todos os arquivos C# em c:\code\SiteApp\Main\SolutionA\Project1.

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

Obter a versão mais recente de um arquivo

O exemplo a seguir obtém a versão mais recente do program.cs no Project1.

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

Obter uma versão específica de um arquivo

O exemplo a seguir obtém a versão 8 do program.cs no Project1.

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

Obter a versão mais recente de dois arquivos

O exemplo a seguir obtém as versões mais recentes de file1.cs e file2.cs no Project1.

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

Sincronizar um espaço de trabalho para corresponder a uma versão da base de código da equipe

O exemplo a seguir sincroniza o espaço de trabalho para corresponder à base de código como ela existia quando o conjunto de alterações 15 foi criado:

c:\code\SiteApp\Main>tf get /v:15
  • O nome e o conteúdo de cada item no espaço de trabalho são alterados para corresponder ao estado em que se encontrava no servidor.
  • Itens que foram excluídos após esse conjunto de alterações serem restaurados para o espaço de trabalho.
  • Itens que foram adicionados após esse conjunto de alterações serem excluídos do espaço de trabalho.

Sincronizar um espaço de trabalho para corresponder a uma versão rotulada da base de código da equipe

O exemplo a seguir sincroniza o espaço de trabalho para corresponder aos itens na base de código que são rotuladosLastKnownGood:

c:\code\SiteApp\Main>tf get /v:LLastKnownGood
  • O nome e o conteúdo de cada item rotulado no espaço de trabalho são alterados para corresponder ao estado em que se encontrava no servidor.
  • Os itens rotulados que foram excluídos são restaurados para o espaço de trabalho.
  • Os itens que não são rotulados no servidor são excluídos do espaço de trabalho.