Undelete, commande

La commande undelete restaure des éléments supprimés précédemment.

Notes

   Les résultats de cette commande ne sont pas visibles dans les autres espaces de travail 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 undelete, vous devez disposer du jeu d'autorisations Extraire avec la valeur Autoriser. Si vous incluez l'option /lock avec une valeur autre que Aucun, vous devez disposer du jeu d'autorisations Verrouiller avec la valeur Autoriser. En outre, vous devez posséder l'espace de travail ou disposer du jeu d'autorisations global Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

tf undelete [/noget] [/lock:(none|checkin|checkout)] 
[/recursive] itemspec[;deletionID] [/login:username,[password]]

Paramètres

Argument

Description

itemspec

Identifie le fichier ou le dossier à restaurer. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments (itemspecs) afin de déterminer quels éléments se trouvent dans la portée, consultez Syntaxe de ligne de commande (Contrôle de version).

deletionID

Spécifie un identificateur unique qui lève toute ambiguïté entre plusieurs éléments du même nom.

username

Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur.

Option

Description

/noget

Restaure l'élément supprimé dans votre espace de travail puis, en attendant la fin d'une opération d'archivage, restaure 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 d'autres utilisateurs d'archiver ou d'extraire les fichiers spécifiés. Pour plus d'informations, consultez Présentation des types de verrous.

Options de verrouillage :

  • Aucun

    Par défaut. Aucun verrou n'est appliqué.

  • Archivage

    Les autres utilisateurs peuvent extraire les éléments spécifiés mais ne peuvent pas archiver les révisions apportées aux fichiers verrouillés tant que vous n'avez pas libéré le verrou en effectuant un 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 ne libérez pas le verrou en effectuant un archivage. Si un autre utilisateur a verrouillé l'un des éléments spécifiés, 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 avec Visual Studio Team Foundation Server.

Notes

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

Lorsque des fichiers ou des dossiers portant le même nom ont été supprimés d'un même dossier du serveur, vous devez inclure une valeur pour le paramètre deletionID afin d'indiquer lequel des éléments supprimés vous souhaitez restaurer. Vous pouvez obtenir un deletionID à l'aide de la commande dir .

Si vous souhaitez modifier le fichier après l'avoir restauré, vous pouvez l'extraire pour le modifier à l'aide de la commande d'extraction habituelle.

Lorsque votre itemspec spécifie un dossier, Team Foundation restaure par défaut tous ses fichiers ainsi que ses sous-dossiers et les fichiers qu'ils contiennent. Si vous ne souhaitez pas restaurer tous les éléments d'un dossier, vous devez tout d'abord restaurer le dossier et ses éléments, puis supprimer les éléments que vous ne souhaitez pas conserver.

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 restaure 314.cs dans le dossier du serveur d'où 314.cs a été supprimé et récupère une copie en lecture seule de la version la plus récente dans l'espace de travail actuel.

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

L'exemple suivant affiche des ID de suppression pour tous les éléments du serveur qui ont été supprimés plus d'une fois.

c:\projects>tf dir $/ /deleted
  • Résultat de l'exemple :

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

L'exemple suivant restaure la version X11 de 314.cs dans le dossier du serveur d'où le fichier a été supprimé et récupère une copie en lecture seule de la version la plus récente dans l'espace de travail actuel.

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

Voir aussi

Référence

Syntaxe de ligne de commande (Contrôle de version)

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

Delete, commande

Dir, commande

Concepts

Modifications en attente

Présentation des types de verrous

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf