Syntaxe de ligne de commande (Contrôle de version)
La syntaxe des commandes pour tf, un utilitaire en ligne de commande Team Foundation, est comme suit :
tf command item [/options]
Cette rubrique décrit les conventions de la documentation, ainsi que les raccourcis de commande, caractères de ligne de commande spéciaux et les paramètres spécifiques 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 souhaitez 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 (**|**Lorsque les options séparées sont entre crochets, vous pouvez spécifier une seule de ces options. Par exemple, le commentaire tf Changeset [/comment:|@commentfile] indique que vous pouvez taper un commentaire pour un ensemble de modifications qui suit l'option /comment: ou ( |) vous pouvez utiliser la **@**syntaxe de commentfile pour spécifier un chemin d'accès à un fichier qui contient 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 les commandes ci-dessus, 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, qui est une abréviation pour spécification d'éléments, est un ensemble d'un ou plusieurs caractères que Team Foundation essaie de résoudre comme un élément adressable ou un ensemble d'éléments, soit sur votre ordinateur soit sur 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 de système de fichiers local, tels que c:\projects, les chemins d'accès UNC, tels que \\myshare\projects, ou les chemins d'accès de 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.
Conseil
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 figurant dans 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 l'un 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 qui pourrait ê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 |
Version téléchargée le plus récemment dans votre espace de travail avec la commande get. |
Wworkspacename;workspaceowner |
Version téléchargée le plus récemment dans l'espace de travail spécifié avec la commande get. Par exemple : WResolveRIConflicts;AKerry |
T |
Dernière version. |
Lorsque vous utilisez les commandes History ou Difference , vous pouvez spécifier une plage de versions en les séparant d'un tilde (~).
Voir aussi
Référence
Concepts
Utilisation de jeux de réservations
Utilisation d'ensembles de modifications
Autres ressources
Référence de la ligne de commande du contrôle de version Team Foundation