Comando localversions (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 localversions do TFVC (Controle de Versão do Team Foundation) exibe a versão de um ou mais itens em um workspace.

Pré-requisitos

Para usar o comando localversions, é necessário ter a permissão para Usar o workspace. Para saber mais, consulte Permissões padrão do TFVC.

Sintaxe

tf localversions ItemSpec
[/recursive] [/format:brief|detailed]
[/workspace:WorkspaceName[;WorkspaceOwner]] [/collection:TeamProjectCollectionUrl]

Parâmetros

Argumentos

Argument

Descrição

<itemspec>

Especifica um arquivo ou uma pasta que contenha os arquivos cujos números de versão você quer exibir.

É possível especificar apenas um arquivo ou pasta local. Por exemplo, c:\project1\binder.cs é válido, mas $/project1/binder.cs não é.

Observação

Você pode especificar mais de um argumento itemspec.

<workspacename>

Use esse argumento com a opção /workspace para especificar um workspace diferente daquele mapeado para o diretório atual.

<workspaceowner>

Use esse argumento com o argumento workspacename se quiser especificar um workspace público.

<TeamProjectCollectionUrl>

A URL da coleção de projetos que contém um ou mais itens para cuja versão você quer exibir, por exemplo, http://myserver:8080/tfs/DefaultCollection.

Opções

Opção

Descrição

/format

Especifica uma das seguintes opções para controlar como os dados retornados por esse comando são exibidos:

  • Brief (padrão): cada diretório aparece apenas uma vez, seguido pelos arquivos que ele contém.
  • Detailed: cada arquivo aparece após o caminho completo.

/recursive

Especifique essa opção se quiser que a operação inclua itens em subpastas.

/workspace

Especifique essa opção para exibir dados sobre as versões dos itens em um workspace diferente daquele mapeado para o diretório atual.

/collection

Especifica a coleção de projetos.

Comentários

Quando você obtém ou faz check-out de um arquivo, geralmente faz o download da versão mais atual. No entanto, podem haver versões mais antigas de alguns arquivos em seu workspace.

Por exemplo, é possível que você tenha feito check-out de alguns arquivos e não tenha feito o check-in do trabalho por várias semanas. Outras pessoas em sua equipe podem ter feito check-in das alterações nos mesmos arquivos durante esse tempo. Nesse caso, as versões desses arquivos em seu workspace seriam mais antigas do que as versões atuais em seu servidor para TFVC. É possível usar o comando localversions para obter informações sobre quais versões desses arquivos estão em seu workspace.

Outros comandos do TFVC fornecem mais informações sobre itens em seu servidor para TFVC e os workspaces que são mapeados para ele. Para saber mais sobre como usar o utilitário de linha de comando tf, consulte Usar comandos do controle de versão do Team Foundation.

Exemplos

O exemplo a seguir exibe a versão do arquivo ControllerBase.cs no workspace mapeado para a pasta c:\workspaces\FeatureA\catalog\controller.

c:\workspaces\FeatureA\catalog\controller>tf localversions ControllerBase.cs

O exemplo a seguir exibe as versões de todos os arquivos, incluindo aqueles em subpastas, no workspace mapeado para a pasta c:\workspaces\FeatureA\catalog. Como a opção /format:detailed é especificada, cada arquivo aparece com seu caminho completo.

c:\workspaces\FeatureA\catalog\>tf localversions . /recursive /format:detailed