Comando Exibir (Controle de Versão do Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
O comando view (TFVC) do Controle de Versão do Team Foundation recupera uma versão específica de um arquivo, armazena-o em uma pasta temporária em seu computador e o exibe.
Pré-requisitos
Para usar o comando view, é necessário ter a permissão de Leitura definida como Permitir. Para saber mais, consulte Permissões padrão do TFVC.
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
Veja nas seções a seguir a descrição dos argumentos e das opções do comando view.
Argumentos
Argument
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 check-in particular. O argumento <owner> opcional é usado para especificar um check-in particular que não pertence ao usuário atual.
<item-spec>
Identifica o arquivo ou pasta a ser recuperado. 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 os comandos de controle de versão do Team Foundation – Use opções para modificar como um comando funciona.
Observação
Você pode especificar mais de um argumento <item-spec>.
<version-spec>
Fornece um valor como C3 para a opção /version. Para obter mais informações sobre como o TFVC analisa especificação de versão para determinar quais itens estão dentro do escopo, consulte Usar comandos do controle de versão do Team Foundation.
<username>
Mostra um valor para a opção /login. É possível especificar esse valor como DOMAIN\<username> ou <username>.
<password>
Mostra um valor para a opção /login.
<local-file>
Fornece o caminho para a pasta de 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 será útil se você quiser gravar o arquivo no disco usando o redirecionamento do console, mas usar um nome ou local diferente do item com versão.
/recursive
Exibe todos os itens no diretório especificado e quaisquer subdiretórios.
/shelveset
Especifica o check-in particular pelo nome.
/noprompt
Especifica que o TFVC não deve solicitar 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 aberta para exibição. Se você omitir essa opção, view recuperará a versão mais recente do servidor do 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
Gera o arquivo para uma pasta local em vez de invocar um shell do Windows para abrir o arquivo.
Comentários
O view comando do tf utilitário da linha de comando recupera uma cópia somente leitura de um arquivo do servidor do Azure DevOps, armazena o arquivo em uma pasta temporária em seu computador e exibe o conteúdo do arquivo. A menos que você estabeleça uma versão específica, o TFVC recuperará a versão mais recente do arquivo do servidor do Azure DevOps.
O comando view não adiciona arquivos ao workspace, nem realiza o check-out deles. Para obter mais informações sobre como obter a versão do servidor do Azure DevOps de um arquivo e marcar-lo, consulte Comando 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 Difference.
Para obter mais informações sobre como usar o tf utilitário de linha de comando, 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\>. Essa 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 verificada com o conjunto de alterações 1999:
c:\projects>tf view /version:C1999 314.cs
O exemplo a seguir recupera a versão 5 de 314.cs e a registra 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