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.

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 delete, 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 également ê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 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 un itemspec pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les options pour modifier le fonctionnement d’une commande.

Notes

Vous pouvez définir plusieurs arguments itemspec.

<username>

Fournit une valeur à l’option /login. Vous pouvez spécifier une valeur de nom d’utilisateur en tant que DOMAIN\username ou username.

Options

Option

Description

/lock

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

Options de verrouillage :

  • none
    Par 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é des éléments spécifiés quelconques, l'opération de verrouillage échoue.

  • checkout
    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. Si d'autres utilisateurs ont verrouillé des éléments spécifiés quelconques, 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 <folder1>\<folder2> et <folder1>\<folder2> lui-même.
  • tf delete <folder1>\<folder2> <filespec> /recursivesupprime tous les fichiers et sous-répertoires correspondant au filespec contenu dans <folder1>\<folder2> 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 à 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, puis 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.

Notes

La commande delete enregistre une modification en attente de type delete dans votre espace de travail pour les éléments que vous spécifiez. Lorsque vous validez une modification en attente de type 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 Undelete.

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

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 tf de ligne de commande, 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 non permanent.

tf delete 314.cs