Rename, commande (contrôle de version Team Foundation)
Mise à jour : novembre 2007
La commande rename modifie le nom ou le chemin d'accès d'un fichier ou d'un dossier. Vous pouvez utiliser la commande rename ou bien les alias move ou ren pour déplacer un fichier ou un dossier vers un nouvel emplacement.
.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 rename, vous devez disposer de l'autorisation Extraire avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf rename [/lock:(none|checkout|checkin)] olditem newitem
Paramètres
Argument |
Description |
|---|---|
olditem |
Nom et chemin d'accès d'origine du fichier ou du dossier à renommer. Vous pouvez spécifier un chemin d'accès d'espace de travail local, tel que C:\myfiles\314.cs, ou un chemin d'accès au serveur de contrôle de version Team Foundation, tel que $/myfiles/314.cs. |
newitem |
Nouveau nom du fichier ou du dossier Vous pouvez utiliser cet argument pour spécifier un emplacement différent sur le chemin d'accès au serveur de contrôle de version Team Foundation ou local. |
Option |
Description |
|---|---|
/lock |
Incluez cette option pour empêcher d'autres utilisateurs d'archiver ou d'extraire les éléments spécifiés. Si cette option n'est pas spécifiée, l'état de verrouillage existant de l'élément n'est pas modifié. Pour plus d'informations, consultez Présentation des types de verrous. Options de verrouillage :
|
Notes
Vous pouvez utiliser la commande rename de l'utilitaire en ligne de commande tf pour déplacer ou renommer un élément sous contrôle de version dans votre espace de travail. Utilisez la commande rename pour déplacer plusieurs fichiers en spécifiant des caractères génériques. La possibilité de renommer plusieurs fichiers ou dossiers sous contrôle de version est uniquement disponible à partir de la ligne de commande.
Utilisez la commande Rename pour effectuer les opérations suivantes :
Renommer olditemen newitem, tel que tf rename 314.cs 315.cs.
Déplacer olditem vers un nouvel emplacement sur le serveur de contrôle de version Team Foundation en fournissant un argument newitem dont le chemin d'accès diffère de celui de l'argument olditem, tel que ** **tf rename 314.cs ..\newdir\314.cs.
Si vous fournissez un argument newitem qui spécifie un dossier inexistant, la commande rename crée le fichier de destination. Si newitem est un dossier, olditem devient un enfant de newitem.
Vous ne pouvez pas renommer un élément si :
Vous l'avez déjà supprimé avant son archivage dans le même espace de travail.
Le nouveau nom existe déjà sur le serveur de contrôle de version Team Foundation et n'est pas un dossier.
Vous avez déjà ajouté, créé une branche ou renommé l'élément dans son archivage en attente.
L'élément est mappé dans l'espace de travail, mais indisponible sur le disque local.
L'élément est masqué.
Vous pouvez renommer un élément pour lequel un fichier du même nom a été ajouté dans l'archivage en attente, mais vous ne pouvez pas renommer un élément branché non encore archivé. Lorsque vous renommez un fichier qui fait l'objet de modifications en attente, les modifications sont conservées.
Un élément qui est explicitement mappé ne peut pas être renommé sans modifier au préalable le mappage. Par exemple, si un dossier de travail mappe de $/ProjectX/MyApp vers c:\MyApp, vous ne pouvez pas renommer MyApp. Vous pouvez renommer les éléments sous MyApp, mais pas MyApp lui-même.
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 change le nom 314.c en 1254.c.
c:\projects>tf rename 314.c 1254.c
L'exemple suivant renomme 314.c en 1254.c et le déplace dans le dossier newdir.
c:\projects>tf rename 314.c ..\newdir\1254.c
L'exemple suivant change le nom Form1.vb en MainPage.vb et lui applique un verrou.
c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin
Voir aussi
Tâches
Comment : déplacer, renommer et supprimer des fichiers et dossiers sous contrôle de version
Concepts
Présentation des types de verrous
Référence
Syntaxe de ligne de commande (Team System)
Delete, commande (contrôle de version Team Foundation)