Partager via

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

  • Article

Mise à jour : novembre 2007

Retire des fichiers et des dossiers du serveur de contrôle de version Team Foundation et les supprime du disque.

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 delete, vous devez disposer de l'autorisation Extraire avec la valeur Autoriser. Si vous incluez l'option /lock avec une valeur autre que Aucun, vous devez disposer de l'autorisation Verrouiller avec la valeur Autoriser. En outre, vous devez posséder l'espace de travail ou disposer de l'autorisation globale Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

tf delete [/lock:(none|checkin|checkout)] [/recursive] itemspec

Paramètres

Argument

Description

itemspec

Identifie le fichier ou le dossier à supprimer du serveur de contrôle de version Team Foundation. 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 Options de ligne de commande.

Option

Description

/lock

Empêche d'autres utilisateurs d'archiver ou d'extraire les éléments 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é. Si vous avez placé un verrou sur le fichier spécifié, cette option le supprime. Il ne supprime pas un verrou placé par quelqu'un d'autre.

  • Archivage

    D'autres utilisateurs peuvent extraire les éléments spécifiés, mais ils ne peuvent pas archiver les révisions dans les fichiers verrouillés tant que vous n'avez pas libéré le verrou en effectuant une opération d'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 n'avez pas libéré le verrou à l'aide d'une opération d'archivage. Si un autre utilisateur a 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-dossier qui correspondent à la spécification d'élément (itemspec) du répertoire spécifié.

  • tf delete folder1\folder2 /recursive (où folder1\folder2 existe et est un répertoire) supprime tous les fichiers et sous-répertoire contenus dans folder1\folder2, et folder1\folder2 lui-même.

  • tf delete folder1\folder2\filespec* /recursive supprime tous les fichiers et sous-répertoires correspondant à la spécification de fichier (filespec), contenus dans folder1\folder2, et chacun de ses sous-répertoires, ainsi que tous les fichiers et sous-répertoires contenus dans chaque répertoire correspondant à la spécification de fichier (filespec).

    Par exemple, dans un espace de travail contenant :

    Folder1\AVeryLongDirectoryName (avec quelques fichiers à l'intérieur) et Folder1\Folder2\AVeryImportantFile.txt

    tf delete 'Folder1\AVer*' /recursive

    supprime folder1\folder2\NeverDelete\AVeryImportantFile.txt parce qu'il correspond au caractère générique.

Notes

La commande delete enregistre une modification en attente de type "delete" dans votre espace de travail pour les éléments que vous avez spécifiés. Lorsque vous validez une modification en attente de type "delete" sur le serveur de contrôle de version Team Foundation à l'aide de la commande ** checkin**, Team Foundation supprime l'élément du serveur de contrôle de version Team Foundation, mais cette suppression n'est pas définitive. Vous pouvez localiser des éléments supprimés dans le serveur de contrôle de version Team Foundation à l'aide de la commande Dir et les restaurer à l'aide de la Undelete, commande.

Si vous avez supprimé un élément dans votre espace de travail sans archiver la modification, vous pouvez restaurer cet élément dans votre espace de travail et annuler la suppression dans la liste des modifications en attente à l'aide de la Undo, commande.

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, Team Foundation marque le fichier comme supprimé dans le serveur de contrôle de version Team Foundation. Si vous-même ou d'autres utilisateurs exécutez par la suite un get de l'élément à partir d'autres espaces de travail, l'élément est supprimé de ces espaces de travail.

Lorsque votre spécification d'éléments (itemspec) spécifie un dossier, Team Foundation supprime par défaut tous ses fichiers, ainsi que ses sous-dossiers et les fichiers qu'ils contiennent.

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 supprime 314.cs sur le disque dans le dossier de l'espace de travail local spécifié puis, lorsque vous archivez la modification, supprime 314.c du système de contrôle de version, de façon non définitive.

c:\projects>tf delete 314.cs

Voir aussi

Tâches

Procédure pas à pas : utilisation du contrôle de version Team Foundation à partir de la ligne de commande

Comment : déplacer, renommer et supprimer des fichiers et dossiers sous contrôle de version

Référence

Undelete, commande

Undo, commande

Dir, commande

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf