Comando Localversions (Team Foundation Version Control)

Serviços do Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

O comando Team Foundation Version Control (TFVC) localversions apresenta a versão de um ou mais itens numa área de trabalho.

Pré-requisitos

Para utilizar o localversions comando, tem de ter a permissão Utilizar para a área de trabalho. Para obter mais informações, veja Permissões de TFVC predefinidas.

Sintaxe

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

Parâmetros

Argumentos

Argumento

Descrição

<itemspec>

Especifique um ficheiro ou uma pasta que contenha os ficheiros para os quais pretende apresentar números de versão.

Só pode especificar um ficheiro ou pasta local. Por exemplo, c:\project1\binder.cs é válido, mas $/project1/binder.cs não é válido.

Nota

Pode especificar mais do que um itemspec argumento.

<workspacename>

Utilize este argumento com a opção /workspace para especificar uma área de trabalho diferente da que está mapeada para o diretório atual.

<workspaceowner>

Utilize este argumento com o workspacename argumento se quiser especificar uma área de trabalho pública.

<TeamProjectCollectionUrl>

O URL da coleção de projetos que contém um ou mais itens para os quais pretende apresentar 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 a forma como os dados devolvidos por este comando são apresentados:

  • Brief (predefinição): cada diretório aparece apenas uma vez, seguido dos ficheiros que contém.
  • Detailed: cada ficheiro é apresentado após o caminho completo.

/recursive

Especifique esta opção se pretender que a operação inclua itens em subpastas.

/workspace

Especifique esta opção para apresentar dados sobre as versões dos itens numa área de trabalho diferente daquela que está mapeada para o diretório atual.

/collection

Especifica a coleção de projetos.

Observações

Quando obtém ou verifica um ficheiro, normalmente transfere a versão mais atual. No entanto, poderá ter versões mais antigas de alguns ficheiros na área de trabalho.

Por exemplo, poderá ter dado saída de alguns ficheiros e não ter dado entrada do seu trabalho durante várias semanas. Outras pessoas na sua equipa podem ter dado entrada das alterações aos mesmos ficheiros durante esse período. Neste caso, as versões destes ficheiros na área de trabalho seriam mais antigas do que as versões atuais no servidor para TFVC. Pode utilizar o localversions comando para obter informações sobre que versões destes ficheiros estão na sua área de trabalho.

Outros comandos TFVC fornecem mais informações sobre os itens no servidor para TFVC e as áreas de trabalho que mapeiam para o mesmo. Para obter mais informações sobre como utilizar o utilitário de tf linha de comandos, veja Utilizar comandos de controlo de versões do Team Foundation.

Exemplos

O exemplo seguinte apresenta a versão do ficheiro ControllerBase.cs na área de trabalho mapeada para a pasta c:\workspaces\FeatureA\catalog\controller .

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

O exemplo seguinte apresenta as versões de todos os ficheiros, incluindo as de subpastas, na área de trabalho mapeada para a pasta c:\workspaces\FeatureA\catalog . Uma vez que a opção /format:detailed é especificada, cada ficheiro é apresentado com o caminho completo.

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