Undelete, commande
Mise à jour : novembre 2007
La commande undelete restaure des éléments supprimés précédemment.
.gif "Remarque") Remarque : |
|---|
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 Comment : archiver les 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)] [/newname:name]
[/recursive] itemspec[;deletionID]
Paramètres
Argument |
Description |
|---|---|
name |
Valeur fournie par l'utilisateur pour l'option /newname. Vous pouvez spécifier soit un chemin d'accès local soit un chemin d'accès au serveur. |
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 afin de déterminer quels éléments se trouvent dans la portée, consultez Syntaxe de ligne de commande (Team System). |
deletionID |
Spécifie un identificateur unique qui lève toute ambiguïté entre plusieurs éléments du même nom. |
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 :
|
/newname |
Renomme l'élément lors de sa restauration. |
/recursive |
Restaure tous les fichiers et sous-dossiers du répertoire spécifié. |
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 .
Pour restaurer un élément dans un dossier du serveur où un élément du même nom existe déjà ou est en attente d'être ajouté, vous pouvez utiliser l'option /newname pour donner un nouveau nom à l'élément restauré. Vous ne pouvez restaurer qu'un seul élément à la fois à l'aide de l'option /newname.
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
Concepts
Présentation des types de verrous
Référence
Syntaxe de ligne de commande (Team System)
Rename, commande (contrôle de version Team Foundation)