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