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

2025-08-26

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2019 | Visual Studio 2022

O comando TFVC (Controle de Versão do Team Foundation) localversions exibe a versão de um ou mais itens em um workspace.

Pré-requisitos

Categoria	Requirements
Permissões	Use a permissão para o workspace definido como Permitir.

Para obter mais informações, consulte permissões TFVC padrão.

Sintaxe

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

Parâmetros

Argumentos

de argumento

descrição

<itemspec>

Especifique um arquivo ou uma pasta que contenha os arquivos para os quais você deseja exibir números de versão.

Você pode especificar apenas um arquivo ou pasta local. Por exemplo, c:\project1\binder.cs é válido, mas $/project1/binder.cs não é válido.

Nota

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 você quiser especificar um workspace público.

<TeamProjectCollectionUrl>

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

Opções

opção

descrição

/format

Especifique uma das seguintes opções para controlar como os dados retornados por este 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 seu caminho completo.

/recursive

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

/workspace

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

/collection

Especifica a coleção de projetos.

Observações

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

Por exemplo, você pode ter verificado alguns arquivos e não verificado em seu trabalho por várias semanas. Outras pessoas em sua equipe podem ter verificado as 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. Você pode usar o comando localversions para obter informações sobre quais versões desses arquivos estão em seu workspace.

Outros comandos TFVC fornecem mais informações sobre itens em seu servidor para TFVC e os workspaces que são mapeados para ele. 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.

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 as de 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