Partilhar via

Comando View (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 | do Visual Studio 2022

O comando Team Foundation Version Control (TFVC) view recupera uma versão específica de um arquivo, armazena-o em uma pasta temporária no seu computador e o exibe.

Pré-requisitos

Para usar o comando view, tenha a permissão Ler definida como Permitir. Para obter mais informações, consulte Default TFVC permissions.

Sintaxe

tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec> 
[/version:<version-spec>] [/login:<username>,[<password>]]

Parâmetros

As seções a seguir descrevem argumentos e opções do comando view.

Argumentos

Argumento

Descrição

<team-project-collection-url>

Fornece a URL da coleção de projetos que contém uma versão específica de um arquivo sobre o qual você deseja recuperar informações, por exemplo, https://myserver:8080/tfs/DefaultCollection.

<shelveset-name> [:<owner>]

Identifica o conjunto de prateleiras. O argumento <owner> opcional é usado para especificar um conjunto de prateleiras que não pertence ao usuário atual.

<item-spec>

Identifica o arquivo ou pasta a ser recuperada. Para obter mais informações sobre como o TFVC analisa o argumento <item-spec> para determinar quais itens estão dentro do escopo, consulte Usar comandos de controle de versão do Team Foundation - Usar opções para modificar como um comando funciona.

Observação

Você pode especificar mais de um <item-spec> argumento.

<version-spec>

Fornece um valor como C3 para a opção /version. Para obter mais informações sobre como o TFVC analisa uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Usar comandos de controle de versão do Team Foundation.

<username>

Fornece um valor para a opção /login. Você pode especificar esse valor como DOMAIN\<username> ou <username>.

<password>

Fornece um valor para a opção /login.

<local-file>

Fornece o caminho para a pasta do arquivo de saída.

Opções

Opção

Descrição

/console

Especifica que a saída do arquivo deve ser direcionada para o console. Essa opção é útil se você quiser gravar o arquivo no disco usando o redirecionamento do console, mas usar um nome ou local diferente do item versionado.

/recursive

Exibe todos os itens no diretório especificado e quaisquer subdiretórios.

/shelveset

Especifica o conjunto de prateleiras por nome.

/noprompt

Especifica que o TFVC não deve avisá-lo antes de exibir cada arquivo quando você incluir uma expressão curinga em um argumento <item-spec> que corresponda a mais de um arquivo.

/version

Especifica a versão do arquivo a ser aberto para visualização. Se você omitir essa opção, view recuperará a versão mais recente do servidor Azure DevOps.

/collection

Especifica a coleção de projetos.

/login

Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

/output

Envia o arquivo para uma pasta local em vez de invocar um shell do Windows para abrir o arquivo.

Comentários

O comando view do utilitário de linha de comando tf recupera uma cópia somente leitura de um arquivo do servidor DevOps do Azure, armazena o arquivo em uma pasta temporária no computador e exibe o conteúdo do arquivo. A menos que você especifique uma versão específica, o TFVC recupera a versão mais recente do arquivo do servidor Azure DevOps.

O comando view não adiciona arquivos ao seu espaço de trabalho nem faz check-out. Para obter mais informações sobre como obter a versão do servidor Azure DevOps de um arquivo e fazer check-out, consulte de comandos Get e comandos Checkout e Edit.

Você pode usar o comando difference para exibir as diferenças entre duas versões de um arquivo. Para obter mais informações, consulte comando Diferença.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.

Opções de saída

  • Por padrão, o TFVC exibe o conteúdo do arquivo no visualizador associado ao seu tipo de arquivo.

  • Se você incluir a opção /console, o TFVC imprimirá o conteúdo do arquivo no console de comando. Da mesma forma, se o TFVC não conseguir localizar um visualizador para o tipo de arquivo especificado, ele imprimirá o conteúdo do arquivo no console de comando.

  • Você pode redirecionar o conteúdo de um arquivo para a saída padrão usando | ou \>. Esta opção fornece uma maneira de salvar o arquivo em outro arquivo ou passá-lo para outro programa para pós-processamento.

Exemplos

O exemplo a seguir exibe a versão mais recente do arquivo 314.cs:

c:\projects>tf view 314.cs

O exemplo a seguir exibe a versão do 314.cs que foi verificado com o conjunto de alterações 1999:

c:\projects>tf view /version:C1999 314.cs

O exemplo a seguir recupera a versão 5 do 314.cs e o grava no arquivo 314.old:

c:\projects>tf view /version:5 314.cs > 314.old

O exemplo a seguir exibe a versão mais recente de cada arquivo que corresponde à expressão curinga *.cs:

c:\projects>tf view *.cs