Commande Renommer (Team Foundation Version Control)

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

La commande rename Team Foundation Version Control (TFVC) modifie le nom ou le chemin d’accès d’un fichier ou d’un dossier. Vous pouvez utiliser la commande rename, ou 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 dans le serveur tant que vous n’avez pas fait d’archivage. Pour plus d’informations, consultez Développer du code et gérer les modifications en attente.

Prérequis

Pour utiliser la commande rename, l’autorisation Extraire définie sur Autoriser. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

Paramètres

Arguments

Argument

Description

<olditem>

Nom d’origine et chemin d’accès du fichier ou dossier à renommer. Vous pouvez définir un chemin d’espace de travail local tel que C:\myfiles\314.cs ou un chemin d’accès serveur TFVC tel que $/myfiles/314.cs.

<newitem>

Nouveau nom du fichier ou du dossier. Vous pouvez l’utiliser pour définir un autre emplacement de chemin d’accès de serveur local ou TFVC.

<username>

Fournit une valeur à l’option /login. Vous pouvez définir une valeur de nom d’utilisateur en tant que DOMAIN\username ou username.

Options

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 Comprendre les types de verrouillages.

Options de verrouillage :

  • None : aucun verrouillage n’est appliqué.
  • Checkin : 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 enlevé le verrouillage en effectuant un archivage. Si d’autres utilisateurs ont verrouillé des éléments spécifiés quelconques, l’opération de verrouillage échoue.
  • Checkout : empêche d’autres utilisateurs d’archiver ou d’extraire l’un des éléments spécifiés jusqu’à ce que vous enleviez le verrouillage en effectuant un archivage. Si d’autres utilisateurs ont verrouillé des éléments spécifiés quelconques, l’opération de verrouillage échoue.

/login

Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.

Notes

Vous pouvez utiliser la commande rename de l’utilitaire de ligne de commande tf pour déplacer ou renommer un élément contrôlé par la version dans votre espace de travail. Utilisez la commande rename pour déplacer plusieurs fichiers en définissant des caractères génériques. La possibilité de renommer plusieurs fichiers ou dossiers contrôlés par la version est disponible uniquement à partir de la ligne de commande.

Utilisez la commande rename pour effectuer les actions suivantes :

  • Renommez olditem en newitem, par exemple tf rename 314.cs 315.cs.
  • Déplacez olditem vers un nouvel emplacement dans le serveur TFVC en fournissant newitem dont le chemin d’accès diffère de celui de olditem, tel que tf rename 314.cs ..\newdir\314.cs.

Si vous fournissez un newitem qui spécifie un dossier inexistant, la commande rename crée le dossier 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 enregistrement dans le même espace de travail.
  • Le nouveau nom existe déjà dans le serveur TFVC et n’est pas un dossier.
  • Vous avez déjà ajouté, ramifié ou renommé l’archivage en attente de l’élément.
  • L’élément est mappé dans l’espace de travail, mais n’est pas disponible 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é en attente d’archivage, mais vous ne pouvez pas renommer un élément qui a été ramifié mais qui n’a pas encore été archivé. Lorsque vous renommez un fichier contenant des modifications en attente, les modifications sont conservées.

Un élément qui est explicitement mappé ne peut pas être renommé sans avoir d’abord modifié le mappage. Par exemple, s’il existe un mappage de dossiers de travail de $/ProjectX/MyApp à c:\MyApp, vous ne pouvez pas renommer MyApp. Vous pouvez renommer des éléments sous MyApp, mais pas MyApp lui-même.

Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de gestion de version Team Foundation.

Exemples

L’exemple suivant remplace le nom de 314.cs par 1254.cs.

c:\projects>tf rename  314.cs  1254.cs

L’exemple suivant renomme 314.cs en 1254.cs et le déplace vers le dossier newdir.

c:\projects>tf rename 314.cs ..\newdir\1254.cs

L’exemple suivant change le nom de Form1.vb en MainPage.vb et lui applique un verrouillage.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin