Syntaxe de ligne de commande (Team System)
Mise à jour : novembre 2007
Syntaxe de l'utilitaire de ligne de commande tf.exe.
tf command item [/options]
Cette rubrique décrit les conventions de documentation ainsi que les raccourcis de commande, les caractères de ligne de commande spéciaux et les paramètres spécifiques de Team Foundation, versionspec et itemspec.
Conventions de documentation
Les [/Brackets] représentent des options qui ne sont pas requises pour exécuter une commande. Les éléments qui ne se trouvent pas entre crochets représentent des paramètres requis pour exécuter l'opération. Par exemple, itemspec est requis et /recursive est facultatif dans la commande suivante :
Exemple de syntaxe : c:\projects>tf getitemspec [/recursive]
Commande réelle : c:\projects>tf get c:\projects /recursive
Autre commande : c:\projects>tf get /recursive
Dans l'autre exemple de commande, Team Foundation déduit que vous avez l'intention d'obtenir le contenu du répertoire actif, c:\projects, et de tous ses sous-dossiers. Par conséquent, bien que le paramètre itemspec soit requis, vous n'êtes pas obligé de le taper.
Lorsque deux options séparées par un trait vertical (|) sont entre crochets, vous pouvez spécifier une seule de ces options. Par exemple, tf Changeset [/comment:comment|@commentfile] indique que vous pouvez taper un commentaire pour un ensemble de modifications après l'option /comment: ou (|) vous pouvez utiliser la syntaxe **@**commentfile pour spécifier le chemin d'accès d'un fichier contenant un commentaire que vous souhaitez utiliser. Toutefois, vous ne pouvez pas spécifier à la fois un commentaire et un fichier de commentaires.
Dans les exemples de syntaxe, 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. Les éléments en gras représentent des options que vous devez inclure textuellement. Par exemple :
Exemple de syntaxe : tf shelvesetsshelvesetname [/recursive]
Commande réelle : c:\projects>tf shelvesets BuddyTest_23
Caractères de ligne de commande spéciaux
Vous pouvez utiliser le caractère « @ », appelé commutateur de fichier de commandes, pour exécuter simultanément un jeu de commandes de Team Foundation. L'avantage principal de l'utilisation d'un commutateur de ligne de commande à partir de l'invite de commandes, d'un fichier de commandes, dans un fichier batch ou un fichier de script est sa rapidité comparée à celle des commandes individuelles. Pour plus d'informations, consultez Options de ligne de commande.
Raccourcis et alias de commande
Les raccourcis et alias de commande définis ci-dessous sont pris en charge pour l'utilitaire de ligne de commande tf :
del = supprimer
diff = différence
edit = extraire
hist = historique
perm = autorisation
prop = propriétés
ren = renommer
rename = déplacer
stat = état
undel = restaurer
Pour plus d'informations sur ces commandes, consultez Commandes de l'utilitaire en ligne de commande Tf.
Analyse des spécifications d'éléments (itemspecs) et de versions (versionspecs) par Team Foundation
Chemins d'accès aux spécifications d'éléments (itemspecs)
Un itemspec, abréviation de spécification d'élément, est un jeu comportant un ou plusieurs caractères que Team Foundation tente de résoudre comme un élément ou un jeu d'éléments faisant référence aux chemins d'accès du système de fichiers ou UNC mappés à un espace de travail ou le serveur de contrôle de version.
Pour toutes les commandes de Team Foundation qui acceptent une spécification d'éléments (itemspec), vous pouvez spécifier les chemins d'accès au système de fichiers locaux, tels que c:\projects, ou aux chemins d'accès UNC, tels que \\myshare\projects, ou les chemins d'accès au serveur, tels que $/projects/myfiles.
Pour les chemins d'accès locaux, vous pouvez fournir des chemins d'accès relatif. Par exemple, si votre répertoire actif est c:\projects et que vous souhaitez extraire tous les éléments dans un sous-répertoire du dossier de projets, vous pouvez taper tf checkout .\* /recursive.
.gif "Remarque") Remarque : |
|---|
Vous pouvez utiliser des caractères génériques dans les commandes de contrôle de version Team Foundation, par exemple: *, ?, et #. |
Si votre spécification d'éléments (itemspec) indique un chemin d'accès au serveur, elle doit être qualifiée complète. Par exemple, vous ne pouvez pas extraire tous les éléments situés sous le dossier $/projects en utilisant ./* comme spécification d'éléments (itemspec).
Spécifications de versions (versionspecs)
La spécification de version (versionspec) permet de préciser la version d'un élément que vous souhaitez utiliser. Vous pouvez spécifier des versions dans une commande en incluant la spécification en tant que partie intégrante de l'option de version (par exemple, /version:C1256) ou en ajoutant la spécification à un nom de fichier avec un point-virgule (par exemple, filename;Lmylabel).
Utilisez un ou plusieurs des modèles suivants pour spécifier une version.
Versionspec |
Description |
|---|---|
Ensemble de modifications |
Version qui appartient au numéro de l'ensemble de modifications changeset. Exemple : C1256. |
Llabel |
Version qui appartient à l'étiquette label. Exemple : Lmylabel. |
Daaaa-mm-jjTxx:xx – ou – Dmm/dd/yyyy – ou – Tout format pris en charge par .NET Framework. – ou – Tous les formats de date de l'ordinateur local. |
Tout format de date et d'heure pouvant être analysé par une méthode .NET Framework. Exemple : D2008-01-21T16:00. Pour plus d'informations sur les formats de date et d'heure pris en charge, consultez l'article DateTime Structure dans la .NET Framework bibliothèque de classes. |
W |
Dernière version récupérée dans votre espace de travail avec la commande get. |
T |
Révision la plus récente. |
Lorsque vous utilisez les commandes History, Difference ou Merge, vous pouvez spécifier une plage de versions en les séparant d'un tilde (~). Consultez les exemples suivants illustrant comment spécifier une plage en séparant les versions avec un tilde :
Pour afficher uniquement l'historique du fichier Form1.cs pour l'ensemble de modifications 137.
Exemple de syntaxe : **tf history /version:**C137~C137
Pour obtenir la différence entre les ensembles de modifications C123 et C125 pour le fichier form.cs.
Exemple de syntaxe : tf difference/versionC123~C125 form1.cs.
Pour fusionner toutes les versions du premier ensemble de modifications à l'ensemble de modifications C125 dans branch2.
Exemple de syntaxe : **tf merge/version:**C125 branch1 branch2.
Voir aussi
Concepts
Utilisation des jeux de réservations du contrôle de version
Utilisation des ensembles de modifications du contrôle de version
Référence
Autres ressources
Référence de la ligne de commande du contrôle de version Team Foundation