Référence de commande du contrôle de version Team Foundation
Vous pouvez utiliser les commandes de contrôle de version pour effectuer pratiquement toutes les tâches que vous pouvez effectuer dans Visual Studio, et également plusieurs tâches qui ne peuvent pas être effectuées dans Visual Studio.Vous pouvez utiliser l'outil tf.exe pour exécuter des commandes de contrôle de version à partir d'une invite de commandes ou dans un script.
Que voulez-vous faire ?
Exécuter une commande
Configurez votre ordinateur de développement
Développer votre application
Interrompre votre travail
Apporter votre contribution
Gérer des fichiers et résoudre des problèmes
Isoler les risques
Comprendre la syntaxe de commande
Spécifiez les éléments affectés par une commande
Utilisez un argument d'itemspec pour spécifier les éléments affectés
Utilisez un argument de versionspec pour spécifier les versions affectées des éléments
Utilisez les options pour modifier la façon dont fonctionne une commande
Utilisez l'option /noprompt pour supprimer les demandes d'entrée de données et rediriger les données de production à la fenêtre d'invite de commandes
Utilisez l'option /login pour spécifier les informations d'identification en exécutant une commande
Utilisez l'option /lock de l'application ou supprimer un verrou
Options contextuelles
Comprendre les codes de sortie
Exécuter une commande
Pour activer l'invite de commandes de Visual Studio, depuis Windows Démarrer, choisissez Microsoft Visual Studio 2012, Visual Studio Tools, puis choisissez l'un des raccourcis Invite de commandes.
Dans la plupart des cas, vous exécutez la commande de contrôle de version dans le contexte d'un dossier mappé dans l'espace de travail.Par exemple, $/SiteApp/Main/ est mappé à c:\code\SiteApp\Main\.Pour obtenir la version la plus récente de tous les éléments dans l'espace de travail :
c:\code\SiteApp\Main\SolutionA>tf get
[!REMARQUE]
Nous ne republions pas actuellement certaines des sujets.Toutefois, vous pouvez lire la version Visual Studio 2010 des sujets suivants.
Configurez votre ordinateur de développement et gérez des espaces de travail
Votre espace de travail est une copie locale de la base de code de votre équipe.Comme il s'agit d'une copie locale sur votre ordinateur de développement, vous pouvez développer et tester votre code de manière isolée jusqu'à ce que vous soyez prêt à archiver votre travail.Voici certaines commandes pour gérer votre espace de travail :
Proxy Command (Visual Studio 2010)
WorkFold Command (Visual Studio 2010)
Workspace Command (Visual Studio 2010)
Workspaces Command (Visual Studio 2010)
Voir aussi : Configurer votre ordinateur de développement et commencer à utiliser le contrôle de version, Gérer vos espaces de travail
Développer votre application
Utilisez ces commandes pour développer votre application sous contrôle de version avec votre équipe :
Add, commande
Ajoute des fichiers et des dossiers et des fichiers au contrôle de versionCheckout (ou Edit), commande
Contrôle un fichier et modifie son statut de modifications en attente en « à modifier ».Delete, commande (contrôle de version Team Foundation) (Visual Studio 2010)
Get, commande
Obtient (télécharge) la dernière version ou une version spécifique d'un ou plusieurs fichiers ou dossiers de Team Foundation Server dans l'espace de travail.Rename, commande (contrôle de version Team Foundation) (Visual Studio 2010)
Status, commande
Affiche des informations sur les modifications en attente des éléments de fichiers et de dossiers dans un ou plusieurs espaces de travail, ou dans un jeu de réservations.Undo, commande
Ignore une ou plusieurs modifications en attente de fichiers ou dossiers.Undelete Command (Visual Studio 2010)
Voir aussi : Développer votre application dans un code base sous contrôle de version.
Interrompre votre travail
Pour diverses raisons, vous devez parfois mettre de côté une partie ou tout votre travail en cours.Pour suspendre et reprendre votre travail, et gérer vos jeux de réservations, utilisez ces commandes :
Shelve, commande (Visual Studio 2010)
Shelvesets Command (Visual Studio 2010)
Unshelve, commande (Visual Studio 2010)
Voir aussi : Interrompre votre travail et gérer vos jeux de réservations.
Apporter votre contribution
Voici comment archiver votre code dans la base de code de l'équipe :
- Checkin, commande
Archive des modifications en attente aux fichiers ou dossiers du serveur.
Voir aussi : Archiver votre contribution au code base de l'équipe.
Gérer des fichiers et résoudre des problèmes
Afficher et gérer les fichiers de contrôle de version et les dossiers
Properties, commande (Visual Studio 2010)
Commande propriété (non documentée)
Dir Command (Visual Studio 2010)
Destroy Command (Visual Studio 2010)
LocalVersions Command (Visual Studio 2010)
Voir aussi : Utiliser l'Explorateur du contrôle de code source pour gérer les fichiers sous contrôle de version.
Afficher et gérer les versions passées
Changeset Command (Visual Studio 2010)
History, commande
Affiche l'historique des révisions d'un ou de plusieurs fichiers et dossiers.Label Command (Visual Studio 2010)
Labels Command (Visual Studio 2010)
Rollback Command (Visual Studio 2010)
Unlabel Command (Visual Studio 2010)
View Command (Visual Studio 2010)
Voir aussi : Afficher et gérer les versions passées.
Comparer les dossiers et les fichiers
Difference Command (Visual Studio 2010)
Folderdiff Command (Visual Studio 2010)
Voir aussi : Afficher et gérer les versions passées.
Résoudre les conflits de fichiers
Resolve Command (Visual Studio 2010)Voir aussi : Résoudre les conflits de fichiers.
Utiliser des verrous de contrôle de version
Lock Command (Visual Studio 2010)Voir aussi : Utiliser des verrous du contrôle de version.
Isoler les risques
Utilisez les commandes suivantes pour isoler les risques d'utilisation des branches :
Branch Command (Visual Studio 2010)
Branches Command (Visual Studio 2010)
Merge Command (Visual Studio 2010)
Merges Command (Visual Studio 2010)
Voir aussi : Isoler les risques à l'aide des branches.
Administrer le contrôle de version
Utilisez les commandes suivantes pour gérer votre système de contrôle de version :
Configure Command (Visual Studio 2010)
Permission Command (Visual Studio 2010)
Voir aussi : Administration du contrôle de version Team Foundation (Visual Studio 2010).
Obtenir de l'aide sur les commandes de contrôle de version
Utilisez les commandes suivantes pour obtenir plus d'informations sur les commandes de contrôle de version :
Help Command (Visual Studio 2010)
Msdn Command (Visual Studio 2010)
Comprendre la syntaxe de commande
La syntaxe de chaque commande apparaît en haut de chaque rubrique de référence.
Arguments requis et optionels
Les arguments non encadrés sont requis.[Brackets] indiquent les arguments facultatifs qui ne sont pas requis pour exécuter une commande.Toutefois, certains arguments facultatifs ont des valeurs par défaut qui s'appliquent à la commande même si vous ne spécifiez pas l'option.
Arguments exclusifs
Lorsque les options sont séparées par un canal (|), Vous pouvez spécifier l'une des options suivantes.
Arguments in extenso et remplaçables
Les éléments en gras représentent des options que vous devez inclure textuellement.Les éléments en italique représentent des paramètres que vous devez remplacer par des caractères réels pour exécuter une commande.
Raccourcis et alias de commande
Certaines commandes prennent en charge les touches d'accès rapide.Par exemple, vous pouvez appeler commande de suppression avec tf delete ou tf del.
Exemple
Par exemple, la Commande d'extraction :
tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]
Examinons les arguments de cet exemple :
itemspec: vous devez remplacer cet argument par itemspec qui spécifie les éléments que vous vérifiez.
/lock:(none|checkin|checkout): Vous n'êtes pas obligé de spécifier l'option /lock .Si vous ne spécifiez pas la valeur, le système spécifie par défaut /lock:none.Sinon, vous pouvez spécifier l'une des options de verrouillage.
Les arguments suivants sont facultatifs et si vous ne les fournissez pas, aucun de leurs effets ne s'applique à la commande :
/recursive: Si vous voulez extraire de manière récursive plusieurs éléments de contrôle dans un dossier, vous devez spécifier cette option mot pour mot.
/login:nom d'utilisateur, mot de passe: Si vous souhaitez exécuter la commande comme un autre utilisateur, vous devez spécifier l'option /login mot pour mot, remplacez nom d'utilisateur par le nom d'utilisateur, et si nécessaire, vous pouvez fournir le mot de passe.
Spécifiez les éléments affectés par une commande
Vous pouvez utiliser des itemspecs et versionspecs pour spécifier quels éléments sont affectés par une commande.
Utilisez un argument d'itemspec pour spécifier les éléments affectés
Vous utilisez itemspec (spécification d'élément) pour spécifier les éléments affectés par une commande.Vous pouvez spécifier des éléments sur un ordinateur client ou sur votre Team Foundation Server.Vous pouvez utiliser des caractères génériques tels que * et ?.
Arguments d'éléments (itemspec) client
Un argument itemspec client spécifie un chemin d'accès aux éléments sur un ordinateur client comme un répertoire (par exemple, c:\code\SiteApp\Main\SolutionA\) un fichier (par exemple, c:\code\SiteApp\Main\SolutionA\Project1\program.cs ou plusieurs fichiers (par exemple, c:\code\SiteApp\Main\SolutionA\*.cs.Vous pouvez également spécifier des chemins d'accès UNC tels que \\myshare\code\SiteApp\Main.
Arguments itemspec serveur
Un argument itemspec serveur spécifie un chemin d'accès aux éléments dans votre Team Foundation Server comme un répertoire (par exemple, $/SiteApp/Main/SolutionA) un fichier (par exemple, $/SiteApp/Main/SolutionA/Project1/program.cs ou plusieurs fichiers (par exemple, $/SiteApp/Main/SolutionA/*.cs.
Vous utilisez généralement des arguments itemspec serveur lorsque vous devez exécuter une commande sur les éléments pas sur l'ordinateur client.Par exemple, vous travaillez sur un ordinateur de développement et devez obtenir des données d'historique des révisions sur certains éléments qui sont dans une collection de projets d'équipe dans laquelle vous ne travaillez pas :
c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive
/noprompt
Plusieurs arguments itemspec
Pour certaines commandes, vous pouvez spécifier plusieurs arguments itemspec .Par exemple :
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
Extrait program.cs et program2.c.
Utilisez un argument de versionspec pour spécifier les versions affectées des éléments
Vous utilisez versionspec (spécification de version) pour spécifier la version des éléments affectés par une commande.Pour fournir versionspec vous pouvez :
Utilisez l'option /version.Par exemple : /version:C44.
Ajoutez le versionspec à un itemspec avec un point-virgule.Par exemple : program1.cs;C44.
Lorsque vous utilisez les commandes History, commande ou Difference Command , vous pouvez spécifier une plage de versions en les séparant d'un tilde (~).Par exemple :
c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012
Utilisez la syntaxe suivante pour spécifier versionspec.
Type |
Syntaxe |
Description |
---|---|---|
Ensemble de modifications |
[C]n |
Spécifie des éléments selon un numéro d'ensemble de modifications.Si un élément qui est dans la portée n'a pas été modifié dans l'ensemble de modifications spécifié, le système prend la version la plus récente de l'élément qui s'est produit avant l'ensemble de modifications spécifié.
Conseil
Vous pouvez omettre C si vous spécifiez uniquement un nombre.
Exemples
– ou –
– ou –
Si readme.txt a été modifié dans l'ensemble de modifications 8, obtient cette version du fichier.Sinon, obtient la dernière version de readme.txt avant la version 8. |
Étiquette |
Llabel |
Spécifie les éléments auxquels label a été appliqué. Exemples
Obtient la version de readme.txt qui a été marquée JulyHotFix.
Récupère la version de tous les éléments étiquetés (et supprime les éléments non étiquetés) dans l'espace de travail tels qu'ils se trouvaient lorsque l'ensemble de modifications étiqueté comme LastKnownGood a été créé, par exemple, peut-être dans le cadre d'un processus de génération automatisé. |
Date et heure |
Dyyyy-mm-ddTxx:xx - ou - Dmm/dd/yyyy - ou - Tout format pris en charge par .NET Framework. - ou - Tout format de date sur l'ordinateur local. |
Spécifie un ensemble de modifications créé à une date et une heure spécifique. Exemples
Met à jour l'espace de travail pour faire correspondre la base de code telle qu'elle existait le 3/22/2004 à 0h00 (minuit).
Met à jour l'espace de travail pour faire correspondre la base de code telle qu'elle existait le 3/22/2004 à 9h00. Pour plus d'informations sur les formats de date et d'heure pris en charge par le .NET framework consultez DateTime et Chaînes de format de date et d'heure standard. |
L'espace de travail (actuel) |
W |
Spécifie la version dans votre espace de travail. |
L'espace de travail (spécifié) |
Wworkspacename; workspaceowner |
Spécifie la version dans un espace de travail spécifié. Par exemple :WResolveRIConflicts;PeterW |
Conseil |
T |
Spécifie la version la plus récente. |
Utilisez les options pour modifier la façon dont fonctionne une commande
Vous pouvez utiliser certaines options communes pour modifier la façon dont fonctionne une commande.
Utilisez l'option /noprompt pour supprimer les demandes d'entrée de données et rediriger les données de production à la fenêtre d'invite de commandes
Utilisez l'option /noprompt pour supprimer les demandes d'entrée de données et rediriger les données de production vers la fenêtre d'invite de commandes.Cette option peut être utile lorsque vous devez utiliser les commandes de contrôle de version dans un script car la commande poursuit sans intervention par un utilisateur, et elles sont disponibles pour que le script effectue des opérations telles que l'analyse ou capturer.
Lorsque vous utilisez cette option, le système :
Supprime toutes les demandes d'entrée :
Les questions ne sont pas posées dans la fenêtre d'invite de commandes.Par exemple, lorsque vous utilisez Undo, commande avec cette option, le système ne vous invite à confirmer si vous souhaitez continuer à annuler les modifications.
Les fenêtres et les boîtes de dialogue ne sont pas affichées.Par exemple, vous utilisez cette option avec Checkin, commande.Au lieu d'afficher la boîte de dialogue Archiver pour que vous confirmiez vos options (quels éléments vous souhaitez archiver ou quels éléments de travail à associer), le système se poursuit avec l'archivage sans confirmation.
Redirige les données de production à l'invite de commandes.Par exemple, vous utilisez cette option avec History, commande.Les données sont affichées dans la fenêtre d'invite de commandes au lieu de fenêtre historique.
Utilisez l'option /login pour spécifier les informations d'identification en exécutant une commande
Utilisez l'option /login pour spécifier le compte d'utilisateur de Team Foundation Server qui exécute une commande.Cette option peut être utile lorsque vous travaillez sur l'ordinateur d'un autre membre de l'équipe.
Par exemple, Julia travaille avec Peter sur son ordinateur de développement.Elle utilise la Commande de verrouillage pour déverrouiller un fichier que elle a verrouillé précédemment :
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword
Si elle souhaite éviter d'avoir son mot de passe en clair dans l'invite de commandes, elle peut sélectionner la commande sans mot de passe :
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI
Une fois qu'il sélectionne cette commande, le système l'invite à entrer son mot de passe dans une boîte de dialogue qui masque son entrée.
Utilisez l'option /lock de l'application ou supprimer un verrou
Important
La meilleure pratique consiste à manipuler l'option /lock avec précaution et à notifier à vos coéquipiers pourquoi vous l'utilisez et quand vous projetez de supprimer le verrou.
Utilisez l'option pour /lock pour appliquer ou supprimer un verrou en même temps que vous exécutez une autre commande telle que Add ou Edit.
/lock:(none|checkin|checkout)
None : aucun verrou n'est placé sur un élément.Si un verrou est déjà en place, il est supprimé.
Checkin ou Checkout : applique un verrou.Consultez Présenter les types de verrous.
[!REMARQUE]
Dans certains cas, l'opération de verrou peut échouer :
Si un autre utilisateur a verrouillé l'un des éléments spécifiés, l'opération de verrouillage échoue.
Le système ignore ce commutateur s'il existe déjà une modification en attente de l'élément.Dans ce cas, vous devez utiliser la Lock Command pour modifier un verrou sur un élément.
Options contextuelles
Vous pouvez abréger les options suivantes :
Option |
Alias d'option |
---|---|
/comment |
-C |
/computer |
-M |
/delete |
-D |
/force |
-P |
/format |
-F |
/help |
-?, -H |
/lock |
-K |
/login |
-Y |
/newname |
-N |
/noprompt |
-I |
/owner |
-O |
/recursive |
-R |
/server |
-S |
/slotmode |
-X |
/template |
-T |
/user |
-U |
/version |
-V |
/workspace |
-W |
Comprendre les codes de sortie
Les commandes de contrôle de version retournent les codes de sortie suivants :
Code de sortie |
Définition |
---|---|
0 |
Succès. |
1 |
Succès partiel ; cela signifie qu'une partie voire la totalité de l'opération a échoué. |
2 |
Commande non reconnue. |
100 |
Échec total. |
Par exemple :
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
Si l'un des fichiers que vous essayez d'extraire ne figure pas sur le serveur, 1 est retourné pour indiquer un succès partiel.