Commande Localversions (Team Foundation Version Control)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

La commande Team Foundation Version Control (TFVC) localversions affiche la version d’un ou de plusieurs éléments dans un espace de travail.

Prérequis

Pour utiliser la commande localversions, vous devez disposer de l’autorisation Utiliser pour l’espace de travail. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

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

Paramètres

Arguments

Argument

Description

<itemspec>

Spécifiez un fichier ou un dossier qui contient les fichiers pour lesquels vous souhaitez afficher les numéros de version.

Vous ne pouvez spécifier qu’un fichier ou un dossier local. Par exemple, c:\project1\binder.cs est valide, mais $/project1/binder.cs n’est pas valide.

Notes

Vous pouvez spécifier plusieurs arguments itemspec.

<workspacename>

Utilisez cet argument avec l’option /workspace permettant de spécifier un espace de travail autre que celui mappé au répertoire actif.

<workspaceowner>

Utilisez cet argument avec l’argument workspacename si vous souhaitez spécifier un espace de travail public.

<TeamProjectCollectionUrl>

URL de la collection de projets qui contient un ou plusieurs éléments pour lesquels vous souhaitez afficher la version, par exemple http://myserver:8080/tfs/DefaultCollection.

Options

Option

Description

/format

Spécifiez l’une des options suivantes pour contrôler la façon dont les données retournées par cette commande s’affichent :

• Brief (valeur par défaut) : chaque répertoire n’apparaît qu’une seule fois, suivi des fichiers qu’il contient.
• Detailed: chaque fichier apparaît après son chemin d’accès complet.

/recursive

Spécifiez cette option si vous souhaitez que l’opération inclue des éléments dans les sous-dossiers.

/workspace

Spécifiez cette option pour afficher des données sur les versions d’éléments d’un espace de travail autre que celle mappée au répertoire actif.

/collection

Spécifie la collection de projets.

Notes

Lorsque vous obtenez ou consultez un fichier, vous téléchargez généralement la version la plus récente. Toutefois, vous avez peut-être des versions antérieures de certains fichiers dans votre espace de travail.

Par exemple, vous avez peut-être extrait certains fichiers et n’avez pas archivé votre travail pendant plusieurs semaines. D’autres personnes de votre équipe ont peut-être vérifié les modifications apportées aux mêmes fichiers pendant cette période. Dans ce cas, les versions de ces fichiers dans votre espace de travail sont antérieures aux versions actuelles de votre serveur pour TFVC. Vous pouvez utiliser la commande localversions pour obtenir des informations sur les versions de ces fichiers dans votre espace de travail.

D’autres commandes TFVC fournissent plus d’informations sur les éléments de votre serveur pour TFVC et les espaces de travail qui y sont mappés. Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de contrôle de version Team Foundation.

Exemples

L’exemple suivant affiche la version du fichier ControllerBase.cs dans l’espace de travail mappé au dossier c:\workspaces\FeatureA\catalog\controller.

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

L’exemple suivant affiche les versions de tous les fichiers, y compris celles des sous-dossiers, dans l’espace de travail mappé au dossier c:\workspaces\FeatureA\catalog. Étant donné que l’option /format:detailed est spécifiée, chaque fichier apparaît avec son chemin d’accès complet.

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