Partager via

Rename, commande (contrôle de version Team Foundation)

  • Article

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.

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 :

  • Aucune   Aucun verrou n'est appliqué.

  • Archivage   D'autres utilisateurs peuvent extraire les éléments spécifiés, mais ils ne peuvent pas archiver les révisions des fichiers verrouillés tant que vous n'avez pas libéré le verrou en effectuant une opération d'archivage. Si un autre utilisateur a verrouillé l'un des éléments spécifiés, l'opération de verrouillage échoue.

  • Extraction   Empêche les autres utilisateurs d'archiver ou d'extraire les éléments spécifiés tant que vous n'avez pas libéré le verrou à l'aide d'une opération d'archivage. Si un autre utilisateur a verrouillé l'un des éléments spécifiés, l'opération de verrouillage échoue.

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

Modifications en attente

Référence

Syntaxe de ligne de commande (Team System)

Add, commande

Delete, commande (contrôle de version Team Foundation)

Get, commande

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf