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

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

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

Pré-requisitos

Consulte 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 que você excluiu acidentalmente de um espaço de trabalho do servidor. Se você usar um espaço de trabalho local, o que é recomendado, é improvável que você tenha que 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ê recebe arquivos, se o registro interno no servidor indicar que o espaço de trabalho já tem a versão que você está recebendo, ele não recupera o item. Esta opção obtém todos os itens, independentemente dos dados contidos no registo interno.

/force

Combina /all e /overwrite.

<itemspec>

Especifica o escopo dos itens a serem obtidos. Você pode especificar mais de um itemspec argumento. Se não itemspec for fornecido, o sistema obterá recursivamente 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 para 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 estiver limpo, na máquina cliente. Essa opção substitui o comportamento padrão e substitui um item gravável, a menos que o item tenha feito check-out. Se você usar um espaço de trabalho local como recomendado, é improvável que tenha que usar essa opção.

/preview

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

/recursive

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

/remap

Veja 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 versão mais recente.

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

Observações

  • Se você está começando uma nova tarefa, provavelmente é uma boa ideia executar tf get para baixar os arquivos mais recentes do servidor antes de fazer check-out dos arquivos e começar seu trabalho. Você pode executar tf get a partir de qualquer pasta em seu espaço de trabalho.

  • Conforme necessário, tf get cria pastas no disco para conter os itens filho baixados pelo comando.

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

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

  • Conflitos podem bloquear o 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 resolver esses conflitos.

Exemplos

Os exemplos a seguir pressupõem que $/SiteApp/Main/ mapeia 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

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

c:\code\SiteApp\Main>tf get

Obter recursivamente 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 ficheiro

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 ficheiro

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

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

Obtenha a versão mais recente de dois ficheiros

O exemplo a seguir obtém as versões mais recentes do 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 estavam no servidor.
  • Os itens que foram excluídos após esse conjunto de alterações são restaurados no espaço de trabalho.
  • Os itens que foram adicionados após esse conjunto de alterações são 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 rotulados LastKnownGood:

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 estavam no servidor.
  • Os itens rotulados que foram excluídos são restaurados no espaço de trabalho.
  • Os itens que não estão rotulados no servidor são excluídos do espaço de trabalho.