Partager via

Référence de commande du contrôle de version Team Foundation

  • Article

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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifConfigurez 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 :

Voir aussi : Configurer votre ordinateur de développement et commencer à utiliser le contrôle de version, Gérer vos espaces de travail

cc31bk2e.collapse_all(fr-fr,VS.110).gifDévelopper votre application

Utilisez ces commandes pour développer votre application sous contrôle de version avec votre équipe :

Voir aussi : Développer votre application dans un code base sous contrôle de version.

cc31bk2e.collapse_all(fr-fr,VS.110).gifInterrompre 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 :

Voir aussi : Interrompre votre travail et gérer vos jeux de réservations.

cc31bk2e.collapse_all(fr-fr,VS.110).gifApporter 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifGérer des fichiers et résoudre des problèmes

cc31bk2e.collapse_all(fr-fr,VS.110).gifIsoler les risques

Utilisez les commandes suivantes pour isoler les risques d'utilisation des branches :

Voir aussi : Isoler les risques à l'aide des branches.

cc31bk2e.collapse_all(fr-fr,VS.110).gifAdministrer le contrôle de version

Utilisez les commandes suivantes pour gérer votre système de contrôle de version :

Voir aussi : Administration du contrôle de version Team Foundation (Visual Studio 2010).

cc31bk2e.collapse_all(fr-fr,VS.110).gifObtenir 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 :

Comprendre la syntaxe de commande

La syntaxe de chaque commande apparaît en haut de chaque rubrique de référence.

cc31bk2e.collapse_all(fr-fr,VS.110).gifArguments 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifArguments exclusifs

Lorsque les options sont séparées par un canal (|), Vous pouvez spécifier l'une des options suivantes.

cc31bk2e.collapse_all(fr-fr,VS.110).gifArguments 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifRaccourcis 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifExemple

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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifUtilisez 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 ?.

cc31bk2e.collapse_all(fr-fr,VS.110).gifArguments 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifArguments 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

cc31bk2e.collapse_all(fr-fr,VS.110).gifPlusieurs 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifUtilisez 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é.

ConseilConseil
Vous pouvez omettre C si vous spécifiez uniquement un nombre.

Exemples

c:\code\SiteApp\Main>tf get readme.txt /v:C8

– ou –

c:\code\SiteApp\Main>tf get readme.txt /v:8

– ou –

c:\code\SiteApp\Main>tf get readme.txt;8

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

c:\code\SiteApp\Main>tf get readme.txt;LJulyHotFix

Obtient la version de readme.txt qui a été marquée JulyHotFix.

c:\code\SiteApp\Main>tf get /version:LLastKnownGood

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

c:\code\SiteApp\Main>tf get /version:D2004-03-22

Met à jour l'espace de travail pour faire correspondre la base de code telle qu'elle existait le 3/22/2004 à 0h00 (minuit).

c:\code\SiteApp\Main>tf get /version:D2004-03-22T09:00

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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifUtilisez 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifUtilisez 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifUtilisez 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.

cc31bk2e.collapse_all(fr-fr,VS.110).gifOptions 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.