Get, commande
Obtient (télécharge) soit la dernière version soit une version spécifique d'un ou plusieurs fichiers ou dossiers de Team Foundation Server dans l'espace de travail. Bien que la commande Get fournisse une interface utilisateur autre que Visual Studio (consultez Télécharger (obtenir) les fichiers depuis le serveur), le processus est fondamentalement identique.
Exigences générales : consultez Référence des autorisations pour Team Foundation Server.
tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]
Paramètres
Paramètre |
Description |
---|---|
/all |
Si vous utilisez un espace de travail local (recommandé), il est improbable vous deviez utiliser cette option. Vous pouvez utiliser cette option pour restaurer un élément que vous avez supprimé par erreur d'un espace de travail du serveur. Votre Team Foundation Server met à jour un enregistrement interne de tous les éléments que l'espace de travail contient, notamment la version de chacun. Par défaut, lorsque vous obtenez des fichiers, si l'enregistrement interne sur le serveur indique que l'espace de travail a déjà la version que vous obtenez, il ne récupère pas l'élément. Cette option obtient les éléments indépendamment des données contenues dans l'enregistrement interne. |
/force |
Combine /all et /overwrite. |
itemspec |
Spécifie le type de l'élément à obtenir. 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 dans l'espace de travail actuel. Pour obtenir la syntaxe, consultez Référence de commande du contrôle de version Team Foundation. |
/login:username,[password] |
Spécifie le compte d'utilisateur pour exécuter la commande. Consultez Référence de commande du contrôle de version Team Foundation. |
/noautoresolve |
Par défaut, le système tente automatiquement de Résoudre automatiquement tous (consultez Résoudre les conflits du contrôle de version Team Foundation). Vous pouvez spécifier cette option pour désactiver ce comportement par défaut. |
/noprompt |
Supprime l'affichage des fenêtres et les boîtes de dialogue et redirige les données de production à l'invite de commandes. Consultez Référence de commande du contrôle de version Team Foundation. |
/overwrite |
Si vous utilisez un espace de travail local (recommandé), il est improbable vous deviez utiliser cette option. Par défaut, le système ne récupère pas un élément s'il est accessible en écriture (autrement dit, si son attribut de lecture seule est supprimé) sur l'ordinateur client. Cette option remplace le comportement par défaut et remplace un élément accessible en écriture, à moins que l'élément soit extrait. |
/preview |
Affiche ce qui se produirait sans exécuter réellement l'opération Get. |
/recursive |
Obtient récursivement tous les éléments dans le répertoire spécifié et ses sous-répertoires. Si vous ne spécifiez pas itemspec, cette option est sous-entendue. |
/remap |
Consultez le blog de phkelley : tf get /remap. |
/version:versionspec |
Spécifie la version maximum, ou les versions minimales et maximales, pour afficher des données historiques. La valeur par défaut est /version:T (la version la plus récente). Pour obtenir la syntaxe, consultez Référence de commande du contrôle de version Team Foundation. |
Exemples
Dans les exemples suivants, supposez que $/SiteApp/Main/ est mappé à c:\code\SiteApp\Main\ dans l'espace de travail.
Obtenir la version la plus récente de tous les éléments dans un espace de travail
c:\code\SiteApp\Main\SolutionA>tf get
Obtient la version la plus récente de tous les éléments dans l'espace de travail. Par exemple, la commande ci-dessus obtiendrait de manière récursive tous les fichiers dans $/SiteApp/Main/ y compris tous ses dossiers enfants.
Obtenez de manière récursive la version la plus récente des éléments d'un certain type dans un dossier
c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive
Obtient la version la plus récente de tous les fichiers C# (.cs) dans c:\code\SiteApp\Main\SolutionA\Project1.
Obtenez la dernière version d'un fichier
c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs
Obtient la version la plus récente de program.cs dans Project1.
Obtenir une version particulière d'un fichier
c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8
Obtient la version 8 de program.cs dans Project1.
Obtenez la dernière version de deux fichiers
c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs
Obtient la version la plus récente de file1.cs et de file2.cs dans Project1.
Synchronisez un espace de travail pour correspondre à une version de la base de code de l'équipe
c:\code\SiteApp\Main>tf get /v:15
Synchronise l'espace de travail pour faire correspondre le code base tel qu'il existait lorsque l'ensemble de modifications 15 a été créé :
Le nom et le contenu de chaque élément dans l'espace de travail est modifié pour correspondre à l'état dans lequel il était sur le serveur.
Éléments supprimés après que l'ensemble de modifications a été restauré dans l'espace de travail.
Éléments ajoutés après que l'ensemble de modifications a été supprimé de l'espace de travail.
Synchronisez un espace de travail pour correspondre à une version étiquetée de la base de code de l'équipe
c:\code\SiteApp\Main>tf get /v:LLastKnownGood
Synchronise l'espace de travail pour faire correspondre les éléments dans le code base qui sont étiquetés LastKnownGood :
Le nom et le contenu de chaque élément étiqueté dans l'espace de travail est modifié pour correspondre à l'état dans lequel il était sur le serveur.
Les éléments étiquetés 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.
Utilisation de Visual Studio
- Télécharger (obtenir) les fichiers depuis le serveur Utilisez Visual Studio pour obtenir des fichiers et des dossiers.
Conseils
Si vous démarrez une nouvelle tâche, il vous est probablement recommandé d'exécuter tf get (vous pouvez le faire à partir de n'importe quel dossier dans votre espace de travail) pour télécharger les derniers fichiers du serveur avant d'extraire des fichiers et démarrer votre travail.
Si nécessaire, cette commande crée les dossiers sur le disque pour contenir les éléments enfants que la commande télécharge.
Vous pouvez consulter les informations sur l'historique d'un élément à l'aide de History, commande et Changeset Command.
Si vous vous préoccupez de quelles modifications peuvent se produire sur les fichiers dans l'espace de travail, vous pouvez utiliser l'option /preview pour consulter les modifications qui se produiraient sans les implémenter en réalité.
Les conflits peuvent empêcher votre commande get. Une cause courante des conflits est d'essayer d'obtenir un élément sur lequel vous avez des modifications en attente. Vous pouvez utiliser Resolve Command pour résoudre ces conflits de données.