Partager via

Get, commande

  • Article

Mise à jour : novembre 2007

Récupère une copie en lecture seule d'un fichier à partir du serveur Team Foundation dans l'espace de travail et crée les dossiers adéquats sur le disque.

Autorisations requises

Pour utiliser la commande get, vous devez disposer de l'autorisation Lire avec la valeur Autoriser pour chaque élément extrait et vous devez posséder l'espace de travail de destination ou disposer de l'autorisation globale Administrer les espaces de travail. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

tf get itemspec [/version:versionspec] [/all] [/overwrite] [/force] 
[/preview] [/recursive] [/remap] [/noprompt]

Paramètres

Argument

Description

Itemspec

Fichier ou dossier à récupérer. Si aucun itemspec n'est fourni, Team Foundation Server procède à une opération récursive Get sur l'espace de travail actuel.

Versionspec

Valeur fournie par l'utilisateur pour l'option /version. Pour plus d'informations sur la façon dont Team Foundation Server analyse une spécification de version afin de déterminer quels éléments se trouvent dans sa portée, consultez Syntaxe de ligne de commande (Team System).

Option

Description

/version

Spécification de version facultative. versionspec correspond à la version de l'élément que vous souhaitez extraire. Vous pouvez spécifier une version par :

  • Date/heure (D2008-01-21T16:00)

  • Version d'ensemble de modifications (C1256)

  • Étiquette (Lmylabel)

  • Version la plus récente (T)

  • Version d'espace de travail (Wworkspacename ; propriétaire)

  • Si aucune version n'est fournie, Team Foundation Server récupère la version serveur la plus récente des itemspec spécifiées dans votre espace de travail.

/all

Force la récupération de tous les fichiers, non seulement de ceux qui sont obsolètes.

/overwrite

Écrase des fichiers accessibles en écriture qui ne sont pas extraits.

/force

Combine /all et /overwrite.

/preview

Affiche ce qui se produirait sans exécuter réellement l'opération Get.

/recursive

Récupère de manière récursive tous les éléments qui correspondent à vos itemspec.

/remap

À utiliser uniquement avec la version Service Pack 1 de Microsoft Visual Studio Team System 2008 Team Foundation Server.

Met à jour les références de base de données de la branche remappée locale pour tous les éléments dont le contenu sur le disque local est identique à celui que vous téléchargez à partir de la branche de contrôle de version.

/noprompt

Supprime les boîtes de dialogue normalement affichées au cours de cette opération.

Notes

La commande get récupère des éléments du serveur dans un espace de travail. Si aucune autre version n'est fournie, la version serveur la plus récente est récupérée. Lorsque vous exécutez une opération get, Team Foundation Server supprime du serveur tous les fichiers marqués localement pour suppression et archivés depuis la dernière fois que vous avez synchronisé votre espace de travail avec le serveur. Les fichiers renommés ou déplacés sur le serveur sont relocalisés sur le disque pour correspondre aux modifications sur le serveur. Les fichiers renommés ou déplacés sur le serveur sont également déplacés sur l'espace de travail local pour correspondre aux modifications sur le serveur.

La commande get ne remplace pas les fichiers que vous avez extraits dans le répertoire de l'espace de travail local. Lorsque vous émettez une commande get pour un élément déjà extrait dans votre espace de travail et que la version de serveur a changé, vous êtes invité à résoudre des conflits de fichiers entre l'espace de travail et la version serveur. Pour plus d'informations, consultez Resolve, commande.

  • Utilisez l'option /all si la version de votre espace de travail est identique à celle du serveur demandé et que vous souhaitez remplacer le fichier sur le disque.

  • Utilisez l'option /overwrite pour forcer le remplacement de la version d'espace de travail actuelle accessible en écriture par une version du serveur spécifié.

  • Utilisez l'option /force, pour remplacer tout élément extrait dans l'espace de travail avec la version du serveur la plus récente. Vous pouvez également utiliser l'option /force pour remplacer une version spécifique.

  • Utilisez l'option /preview pour afficher les modifications qui se produiront lors de l'opération get suivante.

Remarque :

Utilisez fréquemment la commande get pour garder votre espace de travail à jour afin de pouvoir résoudre rapidement les différences entre votre version d'un projet et la version du serveur.

Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.

Utilisation de Get avec l'option /remap

L'option /remap permet de réduire la durée de téléchargement lorsque vous remappez un dossier local à une nouvelle branche ou à une branche différente. Par exemple :

  1. Mappez $/branche1 à D:\branche sur votre ordinateur.

  2. Exécutez tf get pour obtenir une copie de tous les éléments de $/branche1 dans le dossier local.

  3. Modifiez le mappage de $/branche1, puis mappez $/branche2 au dossier local mappé en tant que $/branche1 (D:\branche).

  4. Exécutez tf get avec l'option /remap pour télécharger uniquement le contenu dans $/branche2 qui diffère du contenu de $/branche1 dans le dossier local (D:\branche).

Remarque :

Cette fonctionnalité est disponible uniquement si vous avez installé la version Service Pack 1 de Microsoft Visual Studio Team System 2008 Team Foundation Server.

Exemples

L'exemple suivant récupère la version la plus récente de 314.cs depuis le serveur. Si vous avez des modifications en attente pour 314.cs, Team Foundation Server vous invite à résoudre tous les conflits éventuels.

C:\projects>tf get 314.cs

L'exemple suivant récupère la version 8 de 1256.cs depuis le serveur.

Remarque :

Utiliser 1256.cs;8 équivaut à utiliser 1256.cs;C8. Par défaut, la version de l'ensemble de modifications est utilisée si vous ne spécifiez qu'un nombre après le point-virgule.

 
C:\>tf get 1256.cs;8

L'exemple suivant récupère les versions les plus récentes de tous les éléments démasqués depuis le dossier du serveur et ses sous-dossiers vers le répertoire C:\projects et crée des dossiers locaux aux emplacements nécessaires. Pour plus d'informations sur la façon de masquer et démasquer des dossiers, consultez Workfold, commande.

C:\projects>tf get

Les exemples suivants offrent d'autres moyens de récupérer la version de 1256.cs archivée avec l'ensemble de modifications 1999.

c:\projects>tf get /version:C1999 1256.cs

—ou—

c:\projects>tf get 1256.cs;C1999

L'exemple suivant récupère depuis le serveur la version de tous les éléments démasqués tels qu'ils existaient sur le serveur lorsque l'ensemble de modifications 291 a été créé.

c:\projects>tf get /version:C271

L'exemple suivant récupère build42, étiqueté sous la forme "build42." Cela met votre espace de travail en correspondance avec l'étiquette tant qu'il n'y a pas de modifications en attente. Les fichiers qui ne figurent pas dans l'étiquette sont supprimés du disque local.

c:\projects>tf get /version:Lbuild42

L'exemple suivant récupère la version sur le serveur à une date et une heure spécifiques.

c:\projects>tf get /version:D2008-01-21T16:00

Voir aussi

Tâches

Procédure pas à pas : utilisation du contrôle de version Team Foundation à partir de la ligne de commande

Comment : obtenir la source de votre projet d'équipe

Comment : masquer et dévoiler des dossiers dans un espace de travail

Référence

Resolve, commande

Merge, commande

Checkout et Edit, commandes

Checkin, commande

Unshelve, commande

Workfold, commande

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf