Commande Get (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

La commande get de Team Foundation Version Control (TFVC) permet de récupérer ou de télécharger la dernière version ou une version spécifiée d’un ou plusieurs fichiers ou dossiers de Azure DevOps Server sur l’espace de travail. La commande tf get fournit une interface utilisateur différente de celle de Visual Studio, mais le processus est fondamentalement le même. Pour plus d’informations sur l’utilisation de Visual Studio pour récupérer des fichiers et des dossiers, consultez Télécharger (récupérer) des fichiers à partir du serveur.

Prérequis

Consultez Autorisations TFVC par défaut.

Syntaxe

tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]

Paramètres

Paramètre

Description

/all

Vous pouvez utiliser cette option pour restaurer un élément que vous avez supprimé accidentellement d’un espace de travail serveur. Si vous utilisez un espace de travail local, ce qui est recommandé, il est peu probable que vous ayez à utiliser cette option.

TFVC conserve un enregistrement interne de tous les éléments contenus dans l’espace de travail, y compris la version de chacun d’eux. Par défaut, lorsque vous récupérez des fichiers, si l’enregistrement interne sur le serveur indique que l’espace de travail a déjà la version que vous récupérez, il ne récupère pas l’élément. Cette option récupère tous les éléments, quelles que soient les données contenues dans l’enregistrement interne.

/force

Combine /all et /overwrite.

<itemspec>

Spécifie la portée des éléments à récupérer. Vous pouvez spécifier plusieurs arguments itemspec. Si aucun itemspec n’est fourni, le système obtient de manière récursive tous les éléments de l’espace de travail actuel.

Pour obtenir la syntaxe, consultez Utiliser les commandes de Team Foundation Version Control.

/login <username>,[<password>]

Spécifie le compte d'utilisateur pour exécuter la commande. Consultez Utiliser les commandes de Team Foundation Version Control.

/noautoresolve

Par défaut, le système tente automatiquement de Résoudre automatiquement tout conflit. Pour plus d’informations, consultez Résoudre les conflits Team Foundation Version Control. Spécifiez cette option pour désactiver ce comportement par défaut.

/noprompt

Supprime l’affichage des fenêtres et des boîtes de dialogue de Visual Studio et redirige les données de résultat vers l’invite de commandes. Consultez Utiliser les commandes de Team Foundation Version Control.

/overwrite

Par défaut, le système ne récupère pas un élément s’il est accessible en écriture, c’est-à-dire que son attribut en lecture seule est effacé, sur l’ordinateur client. Cette option remplace le comportement par défaut et remplace un élément accessible en écriture, sauf si l’élément est extrait. Si vous utilisez un espace de travail local comme recommandé, il est peu probable que vous ayez à utiliser cette option.

/preview

Affiche ce qui se produirait, sans effectuer réellement l’opération get.

/recursive

Récupère récursivement tous les éléments dans le répertoire spécifié et ses sous-répertoires, s’il y en a. Si vous ne spécifiez pas de itemspec, cette option est implicite.

/remap

Consultez le blog de phkelley : tf get /remap.

/version:<versionspec>

Spécifie la version maximale, ou les versions minimales et maximales, à afficher dans les données d’historique. La version la plus récente, /version:T, est utilisée par défaut.

Pour obtenir la syntaxe, consultez Utiliser les commandes de Team Foundation Version Control.

Notes

  • Si vous démarrez une nouvelle tâche, il est recommandé d’exécuter tf get pour télécharger les derniers fichiers du serveur avant d’extraire des fichiers et de commencer votre travail. Vous pouvez exécuter tf get à partir de n’importe quel dossier de votre espace de travail.

  • En fonction des besoins, tf get crée des dossiers sur le disque pour contenir les éléments enfants que la commande télécharge.

  • Vous pouvez afficher des informations sur l’historique d’un élément à l’aide de la commande History et de la commande Changeset.

  • Si vous vous inquiétez des modifications qui peuvent se produire dans les fichiers dans l’espace de travail, vous pouvez utiliser l’option /preview pour voir les modifications qui se produiraient sans les implémenter réellement.

  • Les conflits peuvent bloquer votre get. Une cause typique des conflits est la tentative de récupération d’un élément sur lequel vous avez des modifications en attente. Vous pouvez utiliser la commande Resolve pour résoudre ces conflits.

Exemples

Les exemples suivants supposent que $/SiteApp/Main/ est mappé à c:\code\SiteApp\Main\ dans l’espace de travail.

Récupérer la dernière version de tous les éléments dans un espace de travail

Par défaut, la commande tf get récupère les dernières versions de tous les éléments de l’espace de travail. Par exemple, la commande suivante obtient de manière récursive tous les fichiers dans $/SiteApp/Main/, y compris tous ses dossiers enfants.

c:\code\SiteApp\Main>tf get

Récupérer de manière récursive la dernière version des éléments d’un certain type dans un dossier

L’exemple suivant récupère la dernière version de tous les fichiers C# dans c:\code\SiteApp\Main\SolutionA\Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive

Récupérer la dernière version d’un fichier

L’exemple suivant récupère la dernière version de program.cs dans Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs

Obtenir une version particulière d'un fichier

L’exemple suivant récupère la version 8 de program.cs dans Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8

Récupérer la dernière version de deux fichiers

L’exemple suivant récupère les dernières versions de file1.cs et file2.cs dans Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs

Synchroniser un espace de travail pour qu’il corresponde à une version du codebase de l’équipe

L’exemple suivant synchronise l’espace de travail pour qu’il corresponde au codebase tel qu’il existait lors de la création de l’ensemble de modifications 15 :

c:\code\SiteApp\Main>tf get /v:15
  • Le nom et le contenu de chaque élément de l’espace de travail sont modifiés pour correspondre à l’état dans lequel il se trouvait sur le serveur.
  • Les éléments qui ont été supprimés après cet ensemble de modifications sont restaurés dans l’espace de travail.
  • Les éléments ajoutés après cet ensemble de modifications sont supprimés de l’espace de travail.

Synchroniser un espace de travail pour qu’il corresponde à une version étiquetée du codebase de l’équipe

L’exemple suivant synchronise l’espace de travail pour qu’il corresponde aux éléments du codebase étiquetésLastKnownGood :

c:\code\SiteApp\Main>tf get /v:LLastKnownGood
  • Le nom et le contenu de chaque élément étiqueté de l’espace de travail sont modifiés pour correspondre à l’état dans lequel il se trouvait sur le serveur.
  • Les éléments étiquetés qui ont été supprimés sont restaurés dans l’espace de travail.
  • Les éléments qui ne sont pas étiquetés sur le serveur sont supprimés de l’espace de travail.