Branch, commande
Mise à jour : novembre 2007
La commande branch copie un élément ou un ensemble d'éléments qui comprend les métadonnées et l'historique de contrôle de version, d'un emplacement vers un autre dans le serveur de contrôle de version Team Foundation et dans l'espace de travail local.
.gif "Remarque") Remarque : |
|---|
Les résultats de cette commande ne sont pas reflétés au niveau du serveur de contrôle de version Team Foundation tant que vous n'avez pas effectué d'opération d'archivage. Pour plus d'informations, consultez Comment : archiver les modifications en attente. |
Autorisations requises
Pour utiliser la commande branch, vous devez disposer de l'autorisation Lire pour l'élément source et de l'autorisation Extraire pour le dossier cible avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf branch olditem newitem [/version:versionspec] [/noget] [/lock:none|checkin|checkout] [/checkin] [/noprompt]
Paramètres
Argument |
Description |
|---|---|
olditem |
Spécifie le nom du fichier source ou du dossier dont une branche est créée. L'argument olditem peut également contenir des informations de version au format item;version. |
Newitem |
Spécifie le nom du fichier ou du dossier de destination ou le dossier parent de l'emplacement de destination. Si newitem existe déjà et se trouve être un dossier du serveur de contrôle de version Team Foundation, Team Foundation y crée des éléments avec branches. Sinon, newitem spécifie le nom du fichier ou dossier de destination. Des conflits peuvent survenir au moment de l'archivage si la destination existe déjà. |
Versionspec |
Fournit une valeur pour l'option /version. Pour plus d'informations sur la façon dont Team Foundation analyse une spécification de version afin de déterminer quels éléments se trouvent dans sa portée, consultez Syntaxe de ligne de commande (Team System). |
Option |
Description |
||
|---|---|---|---|
/version |
Version de l'élément auquel vous souhaitez créer la branche. Vous pouvez spécifier une version par :
Si aucune version n'est fournie, Team Foundation utilise la logique suivante pour décider quelle version de l'élément doit être copiée dans la nouvelle branche :
Si vous créez une branche pour un fichier dont la version dans l'espace de travail est plus ancienne que la version la plus récente présente sur le serveur de contrôle de version Team Foundation, la branche du fichier est créée par rapport à la version antérieure. |
||
/lock |
Empêche les autres utilisateurs d'archiver ou d'extraire des éléments tant que vous n'avez pas archivé votre branche en attente et les modifications associées. Pour plus d'informations, consultez Présentation des types de verrous. Options de verrouillage :
|
||
/noget |
Si cette option est spécifiée, les copies locales des fichiers et dossiers de la nouvelle branche ne sont pas créées dans l'espace de travail local. Toutefois, les copies locales seront récupérées dans l'espace de travail la prochaine fois que vous exécuterez une opération Get récursive.
|
||
/checkin |
À utiliser uniquement avec la version Service Pack 1 de Microsoft Visual Studio Team System 2008 Team Foundation Server. Archive l'action de branche au moment de la création de la branche. |
||
/noprompt |
Supprime les invites de saisie. |
Notes
Si vous spécifiez un chemin d'accès local, tel que c:\00101, mais que vous ne spécifiez pas de spécification de version (versionspec), Team Foundation se base sur la version locale de votre espace de travail pour créer la nouvelle branche.
Toutefois, si vous spécifiez un chemin d'accès au serveur tel que $/00101/*.cs et que vous ne spécifiez pas de spécification de version (versionspec), Team Foundation se base à la place sur la version la plus récente du serveur de contrôle de version Team Foundation pour créer la nouvelle branche.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant crée un fichier de branche qui contient la version la plus récente de l'espace de travail de 314.cs, lui affecte le nom « 314_branch » et l'enregistre sur le disque dans le répertoire actif, ainsi que dans le dossier du serveur de contrôle de version Team Foundation auquel il mappe.
c:\projects>tf branch 314.cs 314_branch
L'exemple suivant copie tous les fichiers sans modifications en attente dans la version de l'espace de travail de 314.cs depuis son dossier actuel sur le serveur de contrôle de version Team Foundation vers le dossier testdata du même serveur, et depuis le répertoire actif sur le disque vers le dossier de travail qui correspond au dossier testdata du serveur de contrôle de version Team Foundation.
c:\projects>tf branch C:\314.cs $/testdata
L'exemple suivant copie tous les fichiers sans modifications en attente dans la version actuelle de l'espace de travail du dossier testfiles et les fichiers qu'il contient pour tous les éléments depuis son dossier actuel sur le serveur de contrôle de version Team Foundation vers le dossier testfiles_branch du même serveur, et de c:\testfiles vers le dossier local qui correspond au dossier testfiles_branch du serveur de contrôle de version Team Foundation.
c:\projects>tf branch C:\testfiles $/testfiles_branch
L'exemple suivant crée une branche de 314.cs tel qu'il existait dans l'ensemble de modifications #4 pour le fichier. Un fichier de branche intitulé csharp_branch est créé dans le dossier de travail situé sur le disque, ainsi que sur le serveur de contrôle de version Team Foundation.
c:\projects>tf branch C:\314.cs;C4 csharp_branch
L'exemple suivant crée une nouvelle branche de 314.cs tel qu'il existait le 12/12/03. Un fichier de branche intitulé 314_branch est créé dans le dossier de travail situé sur le disque, ainsi que sur le serveur de contrôle de version Team Foundation.
c:\projects>tf branch 314.cs;D12/12/03 314_branch
L'exemple suivant crée une branche de la version de 314.cs à laquelle l'étiquette « Beta1 » a été appliquée, la nomme « Beta1branch » et l'enregistre dans le répertoire actif du disque, ainsi que dans le dossier du serveur de contrôle de version Team Foundation auquel le répertoire actif correspond.
c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch
Voir aussi
Tâches
Procédure pas à pas : fonctionnalités avancées du contrôle de version
Comment : créer des fichiers et des dossiers avec branches
Concepts
Comprendre la notion de branches
Utilisation des ensembles de modifications du contrôle de version