Partager via

Commande Annuler la suppression (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

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

Note

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.

Conditions préalables

Pour utiliser la commande undelete :

  • Disposez de l’autorisation Extraire définie sur Autoriser.
  • Si vous incluez l’option /lock avec une valeur autre que None, définissez l’autorisation Lock sur Autoriser.
  • Vous devez posséder l’espace de travail ou disposer de l’autorisation globale Administrer les espaces de travail défini 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 <item-specification> valeurs pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de contrôle de version Team Foundation.
<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 comme 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 vérifiant les fichiers verrouillés. Si d’autres utilisateurs ont verrouillé l’un des éléments spécifiés, l’opération de verrouillage échoue.
  • Checkout: cette option empêche les autres utilisateurs d’archiver ou d’extraire les éléments spécifiés jusqu’à ce que vous relâchez le verrou en vérifiant les fichiers verrouillés. Si d’autres utilisateurs ont 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 auprès d’Azure DevOps.

Remarques

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 l’achèvement 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 de ligne de commande tf, consultez Utiliser les commandes de contrôle de version Team Foundation.

Exemples

L’exemple suivant restaure 314.cs dans le dossier serveur à partir duquel 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 sur le 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