Get, commande
Récupère une copie en lecture seule d'un fichier à partir du serveur de contrôle de version 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] [/login:username,[password]]
Paramètres
Argument |
Description |
|---|---|
Itemspec |
Fichier ou dossier à récupérer. Si aucune spécification d'éléments (itemspec) n'est fournie, Team Foundation Server procède à une opération Get récursive sur tous les éléments mappés dans l'espace de travail actuel. .gif "Remarque") Remarque
Vous pouvez spécifier plusieurs arguments Itemspec.
|
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 (Contrôle de version). |
username |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
Option |
Description |
|---|---|
/version |
Spécification de version facultative. La spécification de version correspond à la version de l'élément que vous souhaitez extraire. Vous pouvez spécifier une version par :
|
/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. |
/noprompt |
Supprime les boîtes de dialogue normalement affichées au cours de cette opération. |
/remap |
Met à jour le mappage local sur le serveur et les télécharge à nouveau le fichier plus rapidement si vous avez déjà téléchargé le même fichier depuis une autre branche. Remarque
Cette option est mieux utilisée quand vous n'avez pas de mappage local complexe et que vous devez fréquemment basculer entre les branches.
|
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Team Foundation Server. |
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.
Si vous travaillez dans le cadre d'une équipe de développement, get est la commande que vous utilisez le plus souvent parce qu'elle permet de synchroniser tous les fichiers du projet actuel dans votre équipe et s'assure que vous avez la copie la plus récente du travail partagé. La commande get ne remplace pas les fichiers que vous avez extraits dans le répertoire local. Plus vous exécutez la commande get fréquemment dans un environnement d'exploitation combiné, plus les fichiers locaux sont à jour avec ceux de votre équipe. C'est parce qu'une opération get remplit l'espace de travail local avec les modifications archivées sur le serveur par vos coéquipiers. Si vous gardez votre espace de travail à jour en exécutant une opération get à chaque fois que vous voyez une notification d'archivage (d'alertes de projet, par exemple), vous pouvez résoudre rapidement les différences entre votre version d'un projet et la version du projet sur le serveur. Vous pouvez éviter d'apporter des modifications qui peuvent ne pas être faciles à rapprocher avec le serveur lorsque vous archivez vos modifications en attente.
Pendant une opération get , si votre version d'espace de travail est la même que la version du serveur demandée, Team Foundation Server ne remplace pas le fichier sur le disque à moins que l'option /all soit spécifiée. Vous pouvez utiliser l'option /overwrite pour forcer le remplacement de la version d'espace de travail actuelle qui est accessible en écriture par une version de serveur spécifiée de façon à restaurer votre espace de travail à un état cohérent lorsqu'il devient ingérable, ce qui se produit parfois lorsque vous supprimez ou remplacez par erreur plusieurs fichiers sur le disque. Lorsque vous passez l'option /force, Team Foundation Server remplace tous les éléments extraits dans l'espace de travail par la version du serveur la plus récente, à moins que vous ne fournissiez une version spécifique.
Lorsque vous exécutez une opération get, Team Foundation Server supprime de l'espace de travail local tous les fichiers extraits qui ont été supprimés du serveur depuis la dernière fois que vous avez synchronisé votre espace de travail avec la version du serveur. Les fichiers qui ont été renommés ou déplacés sur le serveur sont transférés sur le disque pour refléter les modifications effectuées sur le serveur.
Vous pouvez utiliser l'option /preview pour publier la commande get sans effectuer de mise à jour de l'espace de travail local afin d'avoir un aperçu de ce qui arriverait si vous exécutiez une commande d'obtention réelle.
L'opération d'extraction n'exécute pas une opération d'obtention de la dernière version sur les fichiers qui sont extraits
En tant que développeur utilisant un espace de travail, vous n'êtes pas concerné par les modifications effectuées par d'autres développeurs. Vous pouvez contrôler le moment où accepter des modifications apportées par d'autres développeurs en exécutant une opération Get (Obtenir), selon le cas. Idéalement, vous pouvez mettre à jour la configuration complète de fichiers contrôlés par version et pas seulement un ou deux fichiers car les changements dans un fichier correspondent généralement aux changements appliqués aux autres fichiers. Vous devez vous assurer que vous disposez d'une capture instantanée cohérente des fichiers sous contrôle de version qui peuvent être générés et testés.
Par conséquent, l'opération d'extraction n'obtient pas la dernière version lors de l'extraction des fichiers. La mise à jour d'un fichier extrait peut entraîner la violation de l'instantané cohérent et aboutir à une configuration de fichiers sous contrôle de version impossibles à générer ou tester. Autrement Team Foundation Server vous force à exécuter l'opération d'obtention de la dernière version à un certain moment avant que vous archiviez vos modifications afin que, lorsque vous essayez d'archiver vos modifications et que vous n'avez pas la copie la plus récente, la boîte de dialogue de résolution des conflits s'affiche.
Vous pouvez également configurer Team Foundation Server pour obtenir la dernière version lors de l'extraction. Pour plus d'informations, consultez Configurer des paramètres d'extraction.
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.
Processus de commande get
Lorsque vous émettez une commande get à partir du serveur 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 récupérée. Pour plus d'informations, consultez Resolve, commande.
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 contre 314.cs, Team Foundation Server initialise le processus de Résolution qui vous aide à décider comment gérer des conflits.
C:\projects>tf get 314.cs
L'exemple suivant récupère la version 8 de 1256.cs depuis le serveur.
Notes
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
Obtenir la source de votre projet d'équipe
Masquer et dévoiler des dossiers dans un espace de travail