Partager via

Commande Delete (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

La commande delete supprime les fichiers et dossiers du serveur Azure DevOps et les supprime du disque.

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 delete, 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 également posséder l’espace de travail ou disposer de l'globale Administrer les espaces de travail l’autorisation définie sur Autoriser. Pour plus d’informations, consultez autorisations TFVC par défaut.

Syntaxe

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

Paramètres

Arguments

argument

Description

<itemspec>

Identifie le fichier ou le dossier à supprimer du serveur Azure DevOps. Pour plus d’informations sur la façon dont TFVC analyse une itemspec pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser des options pour modifier la façon dont une fonction de commande.

Note

Vous pouvez spécifier plusieurs arguments itemspec.

<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

Empêche les autres utilisateurs d’archiver ou d’extraire les éléments spécifiés. Pour plus d’informations, consultez Understanding Lock Types.

Options de verrouillage :

  • none
    Faire défaut. Aucun verrou n’est appliqué. Si vous avez placé un verrou sur le fichier spécifié, cette option la supprime. Il ne supprime pas un verrou placé par quelqu’un d’autre.

  • 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.

/recursive

Supprime tous les fichiers et/ou dossiers et sous-dossiers qui correspondent aux itemspec du répertoire spécifié.

  • tf delete <folder1>\<folder2> /recursive supprime tous les fichiers et sous-répertoires contenus dans <dossier1>\<dossier2>, et <dossier1>\<dossier2> lui-même.
  • tf delete <folder1>\<folder2> <filespec> /recursive supprime tous les fichiers et sous-répertoires correspondant aux filespec contenus dans <dossier1>\<dossier2> et chacun de ses sous-répertoires, ainsi que tous les fichiers et sous-répertoires contenus dans n’importe quel répertoire qui correspond au filespec.

Par exemple, dans un espace de travail contenant :

Folder1\AVeryLongDirectoryName avec certains fichiers à l’intérieur et Folder1\Folder2\AVeryImportantFile.txt,

tf delete Folder1 AVer* /recursive

supprime Folder1\AVeryLongDirectoryName et tous ses fichiers, et supprime Folder1\Folder2\AVeryImportantFile.txt, car il correspond au caractère générique.

/login

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

Remarques

La commande delete enregistre une modification de type en attente delete dans votre espace de travail pour les éléments que vous spécifiez. Lorsque vous validez une modification de type en attente de delete sur le serveur Azure DevOps à l’aide de la commande checkin, TFVC supprime l’élément du serveur Azure DevOps, mais ne le supprime pas définitivement. Vous pouvez localiser les éléments supprimés dans le serveur Azure DevOps à l’aide de la commande dir, et vous pouvez restaurer des éléments supprimés à l’aide de la commande Annuler la suppression.

Si vous avez supprimé un élément dans votre espace de travail mais que vous n’avez pas archivé la modification, vous pouvez restaurer l’élément dans votre espace de travail et supprimer la suppression de votre liste de modifications en attente à l’aide de la commande Annuler.

Vous ne pouvez pas supprimer un élément pour lequel une autre modification en attente existe. Par exemple, un fichier extrait ne peut pas être supprimé. Pour supprimer ces éléments, vous devez annuler la modification en attente actuelle à l’aide de la commande undo.

Lorsque vous archivez une suppression en attente, TFVC marque le fichier comme supprimé sur le serveur Azure DevOps. Par la suite, l’exécution d’un get de l’élément à partir d’autres espaces de travail, que ce soit par vous ou d’autres utilisateurs, supprime l’élément de ces espaces de travail.

Lorsque votre itemspec spécifie un dossier, TFVC supprime tous ses fichiers et sous-dossiers et les fichiers qu’ils contiennent, par défaut.

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 supprime 314.cs sur le disque dans le dossier d’espace de travail local spécifié, puis, lorsque vous archivez la modification, supprime 314.cs du système de contrôle de version de manière non permanente.

tf delete 314.cs