Rename, commande (contrôle de version Team Foundation)
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.
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 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)] [/login:username,[password]] 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. |
nom_utilisateur |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
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 :
|
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server. |
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 :
Renommez olditem en newitem, par exemple 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 autre fichier du même nom a été ajouté pour l'archivage en attente mais vous ne pouvez pas renommer un élément possédant des branches mais qui n'est pas archivé. Lorsque vous renommez un fichier qui comporte des 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
Déplacer, renommer et supprimer des fichiers et dossiers sous contrôle de version
Référence
Syntaxe de ligne de commande (Contrôle de version)
Delete, commande (contrôle de version Team Foundation)
Concepts
Présentation des types de verrous