Branch, commande
La commande branch copie un élément ou un ensemble d'éléments, y compris les métadonnées et l'historique de contrôle de version, d'un emplacement vers un autre sur le serveur de contrôle de version Team Foundation et dans l'espace de travail local.
Notes
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 Archiver des modifications en attente.
Autorisations requises
Pour utiliser la commande branch, vous devez disposer de l'autorisation Lire pour l'élément source et des autorisations Extraire et Fusionner 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)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]]
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 correspond à un dossier du serveur de contrôle de version Team Foundation, Team Foundation crée des éléments avec branches dans celui-ci. 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 (Contrôle de version). |
comment |
Fournit une observation au sujet de la branche. |
@commentfile |
Spécifie le chemin d'accès d'un fichier qui contient le commentaire utilisé pour l'archivage. |
authorname |
Valeur fournie par l'utilisateur pour l'option /author. |
username |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
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.
Remarque
Vous pouvez empêcher des éléments, tels que le contenu d'un dossier /images, d'être récupérés dans votre espace de travail au cours d'opérations Get et Get Latest récursives, en masquant un dossier d'espace de travail.Pour plus d'informations, consultez Workfold, commande.
|
/noprompt |
Supprime les invites de saisie. |
/silent |
Implique /noget et indique que la sortie n'est pas écrite dans la fenêtre d'invite de commandes quand vous créez une branche. |
/checkin |
Crée et archive la branche sur le serveur en une opération. Cette option ne crée aucune modification en attente dans l'espace de travail local. |
/comment |
Ajoute un commentaire à la nouvelle branche. Cette option est utilisée seulement avec l'option /checkin. |
/author |
Identifie l'auteur de la nouvelle branche. Cette option est utilisée seulement avec l'option /checkin. |
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 était 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
Créer des branches de dossiers et de fichiers
Référence
Concepts
Utilisation d'ensembles de modifications