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

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) localversions exibe a versão de um ou mais itens em um espaço de trabalho.

Pré-requisitos

Para usar o localversions comando, você deve ter a permissão Usar para o espaço de trabalho. 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

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 itemspec argumento.

<workspacename>

Use esse argumento com a /workspace opção para especificar um espaço de trabalho diferente daquele que está mapeado para o diretório atual.

<workspaceowner>

Use esse argumento com o workspacename argumento se quiser especificar um espaço de trabalho 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 aparecem:

  • 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 dos itens em um espaço de trabalho diferente daquele que está mapeado para o diretório atual.

/collection

Especifica a coleção de projetos.

Observações

Quando você recebe 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 espaço de trabalho.

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

Outros comandos TFVC fornecem mais informações sobre itens em seu servidor para TFVC e os espaços de trabalho mapeados para ele. Para obter mais informações sobre como usar o utilitário de linha de tf comando, 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 espaço de trabalho 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 espaço de trabalho mapeado para a pasta c:\workspaces\FeatureA\catalog . Como a /format:detailed opção é especificada, cada arquivo aparece com seu caminho completo.

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