Commande Undelete (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

La commande Team Foundation Version Control (TFVC) undelete restaure les éléments précédemment supprimés.

Notes

Les résultats de cette commande ne sont pas visibles dans d’autres espaces de travail tant que vous n’avez pas effectué une opération d’archivage. Pour plus d’informations, consultez Développer du code et gérer les modifications en attente.

Prérequis

Pour utiliser la commande undelete :

  • Vous devez disposer de l’autorisation Extraire définie sur Autoriser.
  • Si vous incluez l’option /lock avec une valeur autre que None, vous devez avoir l’autorisation Verrouiller définie sur Autoriser.
  • Vous devez être propriétaire de l’espace de travail ou avoir l’autorisation Administrer les espaces de travail globale définie sur Autoriser.

Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf undelete [/noget] [/lock:(none|checkin|checkout)] 
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]

Paramètres

Les sections suivantes décrivent les arguments et les options de la commande undelete.

Arguments

Argument Description
<item-specification> Identifie le fichier ou le dossier à restaurer. Pour plus d’informations sur la façon dont TFVC analyse les valeurs <item-specification> pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de Team Foundation Version Control.
<deletion-ID> Spécifie un identificateur unique qui désambigue plusieurs éléments supprimés portant le même nom.
<username> Fournit une valeur à l’option /login. Vous pouvez spécifier cette valeur en tant que DOMAIN\<username> ou <username>.

Options

Option

Description

/noget

Restaure l’élément supprimé dans votre espace de travail. En attente d’achèvement d’une opération d’archivage, cette option restaure ensuite l’élément sur le serveur, mais ne récupère pas immédiatement une copie physique de l’élément sur le disque.

/lock

Empêche les autres utilisateurs d’archiver ou de extraire les fichiers spécifiés. Pour plus d’informations, consultez Comprendre les types de verrous.

Options de verrouillage :

  • None : cette option est la valeur par défaut. 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 des fichiers verrouillés. Si d'autres utilisateurs ont verrouillé des éléments spécifiés quelconques, l'opération de verrouillage échoue.
  • Checkout : cette option empêche d’autres utilisateurs d’archiver ou d’extraire l’un des éléments spécifiés jusqu’à ce que vous libériez le verrou en effectuant un archivage des fichiers verrouillés. Si d'autres utilisateurs ont verrouillé des éléments spécifiés quelconques, l'opération de verrouillage échoue.

/recursive

Restaure tous les fichiers et sous-dossiers du répertoire spécifié.

/login

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

Notes

La commande undelete de la fonctionnalité de ligne de commande tf planifie les fichiers ou dossiers spécifiés pour la restauration en attente de la fin d’une opération d’archivage. Il récupère également les éléments spécifiés du serveur sur le disque local, sauf si vous incluez explicitement l’option /noget.

Lorsque des fichiers ou dossiers portant le même nom ont été supprimés du même dossier serveur, vous devez inclure une valeur pour le paramètre <deletion-ID> pour indiquer quels éléments supprimés vous souhaitez restaurer. Vous pouvez obtenir un <deletion-ID> à l’aide de la commande dir.

Si vous souhaitez modifier un fichier après la restauration, consultez le fichier pour modification à l’aide de la commande checkout comme d’habitude.

Lorsque votre valeur <item-specification> spécifie un dossier, TFVC restaure par défaut tous les fichiers et sous-dossiers du dossier et les fichiers qu’ils contiennent. Si vous ne souhaitez pas restaurer tous les éléments d’un dossier, vous devez d’abord annuler la suppression du dossier et de ses éléments, puis supprimer les éléments que vous ne souhaitez pas conserver.

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

Exemples

L’exemple suivant restaure 314.cs dans le dossier serveur dont 314.cs a été supprimé. La commande récupère également une copie en lecture seule de la dernière version de l’espace de travail actuel.

C:\projects>tf undelete c:\math\314.cs

L’exemple suivant affiche les ID de suppression pour tous les éléments du serveur qui ont été supprimés plusieurs fois :

c:\projects>tf dir $/ /deleted

La sortie de la commande précédente peut ressembler à l’exemple suivant :

$/projects/math/314.cs;X10
$/projects/math/314.cs;X11

L’exemple suivant restaure la version X11 de 314.cs dans le dossier serveur dont le fichier a été supprimé. La commande récupère également une copie en lecture seule de la dernière version de l’espace de travail actuel.

c:\projects>tf undelete 314.cs;X11