Scripts et fichiers de commandes du contrôle de version Team Foundation
Mise à jour : novembre 2007
Vous pouvez assembler et exécuter plusieurs commandes de contrôle de version Team Foundation au niveau de l'invite de commandes en redirigeant une commande vers un fichier batch ou en les incluant dans un lot de fichiers ou de scripts.
Fichiers de commandes : création de groupes de commandes
Un fichier de commandes vous permet une exécution plus rapide que pour une série de commandes individuelles parce qu'un fichier de commandes réutilise une connexion unique au serveur de couche Application et crée une seule instance de tf.
Le commutateur de fichier de commandes est représenté par le symbole @. Pour appeler un fichier de commandes à l'aide de tf, utilisez la syntaxe suivante :
tf @commandfilename.tfc argument1 argument2 …
L'exemple suivant demande à Team Foundation de rechercher des instructions supplémentaires dans le fichier buildcommands.tfc. Cet exemple contient l'entrée suivante et obtient la dernière version de 314.cs à partir du serveur de contrôle de version Team Foundation, l'extrait dans l'espace de travail, la branche à c:\newbranch\, et valide les modifications sur le serveur de contrôle de version Team Foundation.
c:\projects>tf @buildcommands.tfc 314.cs c:\newbranch\
Contenu de buildcommands.tfc :
get %1
checkout %1
branch %1 %2
checkin
Lorsque le commutateur de fichier de commandes est spécifié, vous pouvez inclure autant d'arguments que vous souhaitez. Les arguments fournissent des valeurs aux commandes contenues dans votre fichier de commandes. Les arguments standard incluent les noms de fichiers, les chemins d'accès, les noms de connexions, les commentaires et les spécifications de versions (versionspecs).
Suppression et restauration de l'interactivité de l'invite de commandes
Par défaut, les fichiers de commandes ne sont pas interactifs. Un certain nombre de commandes, telles que undo, utilisent le mode interactif comme valeur par défaut en cas d'exécution à l'aide de l'application en ligne de commande tf. Lorsque vous exécutez des commandes Team Foundation individuelles, vous pouvez inclure l'indicateur /noprompt pour contourner des messages d'avertissement et exécuter ces commandes de façon non interactive. Dans les fichiers de commandes, /noprompt est inclus implicitement.
Exemple de fichier de commandes
Lorsque vous exécutez la commande suivante, Team Foundation analyse le fichier BuildProject.tfc et crée l'espace de travail HumongousInsurance 2.3, obtient la version la plus récente du projet HumongousInsurance, crée une branche de la nouvelle version dans Humongous Insurance V2.3 et étiquette la nouvelle version. Pour chaque nouvelle génération, elle exécute simplement le fichier de commandes avec le nom du projet ainsi que le nouveau numéro de version et le répertoire local.
c:\>tf @BuildProject.tfc HumongousInsurance 2.3 c:\projects
Contenu de BuildProject.tfc :
cd %3
rem Change the current directory from whatever it is to the project folder.
workspace /new /s:TeamServer2 /user:UNO\juan %1BuildWS%2
rem Create a new workspace on the TeamServer2 server as user UNO\juan.
rem Assign a name to the workspace that concatenates the first command line argument (%1) + "BuildWS" + the second command line argument (%2)
get %1 /recursive
rem retrieve the latest version of the first command line argument.
branch %1 %1V%2
checkin /comment:”This is build v%2 of %1”
label %1Build%2 /category:builds /comment:”%1 Build %2” %1V%2
workspace /delete %1BuildWorkspace%2
Voir aussi
Concepts
Référence
Syntaxe de ligne de commande (Team System)