Partager via

Détruire des fichiers à version contrôlée

  • Article

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

Visual Studio 2019 | Visual Studio 2022

Au fil du temps, un serveur de contrôle de version acquiert un nombre croissant de fichiers et de dossiers. Cela peut entraîner des problèmes lorsque vous essayez de gérer les besoins en espace disque. Vous pouvez être obligé de supprimer tous les projets et leurs hiérarchies du contrôle de version. Par exemple, un projet peut être créé à des fins d’apprentissage uniquement, ou peut-être certains fichiers sont contaminés par un virus. Par conséquent, en tant qu’administrateur TFVC, vous devrez peut-être détruire des fichiers et dossiers sous contrôle de version.

La procédure suivante vous montre comment détruire des fichiers et des dossiers à l’aide de la commande tf destroy. Bien que les fichiers soient définitivement supprimés, vous pouvez conserver l’historique associé. Pour plus d’informations sur les options et les arguments disponibles pour tf destroy, consultez commande Destroy (Team Foundation Version Control).

Remarque

L’opération destroy est disponible uniquement à partir de la ligne de commande.

Conditions préalables

  • Pour utiliser la commande destroy, vous devez être membre du groupe de sécurité Administrateurs Team Foundation . Pour plus d’informations, consultez Autorisations TFVC par défaut.

  • Avant d’exécuter tf destroy sans l’option /keephistory, commencez par supprimer les fichiers que vous souhaitez détruire. Pour plus d’informations, consultez Supprimer des fichiers et des dossiers du contrôle de version. Après avoir supprimé un fichier, son nom de fichier inclut désormais un ID de suppression. Par exemple, si un nom de fichier est aFile.cs, après la suppression, le nom de fichier est aFile.cs ; x123, où x123 est l’ID de suppression.

    Après avoir supprimé les fichiers, vous pouvez synchroniser l’entrepôt TFVC. Sinon, l’entrepôt ne sera pas synchronisé avec les éléments détruits.

Pour supprimer définitivement les fichiers sous contrôle de version

Dans Windows, sélectionnez Démarrer, puis saisissez Invite de commandes développeur. Dans les résultats de recherche, choisissez l'invite de commandes développeur correspondant à votre version de Visual Studio, par exemple invite de commandes développeur pour Visual Studio 2022.

  • Pour simuler la destruction du fichier aFile.cs sans le détruire, tapez dans l'invite de commande :

    tf destroy /preview /i $/MyTeamProject/aFile.cs

    Remarque

    Le texte de la fenêtre d’invite de commandes affiche Destroyed: $/MyTeamProject/aFile.cs, mais le fichier n’est pas réellement détruit lorsque vous utilisez l’option /preview.

  • Pour détruire le fichier aFile.cs, entrez dans l’invite de commandes :

    tf destroy /i $/MyTeamProject/aFile.cs

    Cette commande affiche des informations sur les modifications et les jeux de réservation en attente possibles dans la fenêtre d’invite de commandes. Si vous spécifiez /i ou non interactif, vous n'êtes pas invité à répondre à une boîte de dialogue Oui, Nonou Oui à tous avant la suppression définitive des fichiers.

  • Pour détruire tous les fichiers dans aFolder et en même temps conserver leur historique, entrez :

    tf destroy /keephistory $/MyTeamProject/aFolder

    Remarque

    Vous ne pouvez pas spécifier /preview avec /keephistory.

    Cette action conserve les informations historiques sur tous les fichiers dans aFolder. Vous pouvez utiliser la commande tf history pour afficher l’historique d’un fichier. Vous pouvez également afficher l’historique dans Explorateur de contrôle de code source dans Visual Studio. Pour plus d’informations, consultez Commande History et Obtenir l’historique d’un élément.

  • Utilisez l’option /stopat pour conserver les informations historiques jusqu’à une valeur de versionspec. La valeur versionspec peut être la dernière version, un ensemble de modifications spécifique ou une date. Pour plus d’informations sur les valeurs versionspec, consultez Utilisez les commandes de contrôle de version de Team Foundation.

    Pour détruire tous les fichiers du projet MyTeamProject et conserver en même temps l’historique des fichiers jusqu’au 23/10/23/2005, entrez :

    tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005

  • Utilisez l’option /startcleanup pour nettoyer immédiatement les métadonnées TFVC des fichiers qui ne sont plus référencés par Azure DevOps Server. Sans cette option, ces métadonnées sont supprimées lorsque la base de données est conservée par un processus SQL qui s’exécute tous les cinq jours. Sept jours après la suppression des métadonnées TFVC, le contenu des fichiers détruits est supprimé par un autre processus SQL.

    Pour détruire immédiatement tous les fichiers de aFolder, entrez :

    tf destroy /startcleanup $/MyTeamProject/aFolder