Partager via

Commande Renommer (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation Version Control (TFVC) rename commande 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.

Note

Les résultats de cette commande ne sont pas reflétés dans le serveur tant que vous n’avez pas effectué d’archivage. Pour plus d’informations, consultez Développer du code et gérer les modifications en attente.

Conditions préalables

Pour utiliser la commande rename, disposez de 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 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 de serveur TFVC tel que $/myfiles/314.cs.

<newitem>

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

<username>

Fournit une valeur à l’option /login. Vous pouvez spécifier une valeur de nom d’utilisateur comme DOMAIN\username ou username.

Options

option

Description

/lock

Incluez cette option pour empêcher d’autres utilisateurs d’archiver ou de 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 verrous.

Options de verrouillage :

  • None: aucun verrou 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 libéré le verrou en effectuant un archivage. Si d’autres utilisateurs ont verrouillé l’un des éléments spécifiés, l’opération de verrouillage échoue.
  • Checkout: empêche les autres utilisateurs d’archiver ou d’extraire l’un des éléments spécifiés jusqu’à ce que vous relâchez le verrou en effectuant un archivage. Si d’autres utilisateurs ont verrouillé l’un des éléments spécifiés, 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.

Remarques

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 spécifiant 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 le olditem en newitem, par exemple tf rename 314.cs 315.cs.
  • Déplacez l'olditem vers un nouvel emplacement dans le serveur TFVC en fournissant un newitem dont le chemin diffère de celui du 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 d’être archivé 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é, branché ou renommé l’archivage en attente de l’élément.
  • L’élément est mappé dans l’espace de travail, mais 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é branché, mais pas encore archivé. Lorsque vous renommez un fichier qui a des modifications en attente, les modifications sont conservées.

Un élément qui est explicitement mappé ne peut pas être renommé sans modifier d’abord le mappage. Par exemple, s’il existe un mappage de dossier de travail de $/ProjectX/MyApp à c :\MyApp, vous ne pouvez pas renommer Monapp. 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 contrôle de version Team Foundation.

Exemples

L’exemple suivant modifie le nom de 314.cs en 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 modifie le nom de Form1.vb pour MainPage.vb et applique un verrou à celui-ci.

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