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 gestion 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 de la gestion de version. Par exemple, un projet peut être créé à des fins d’apprentissage uniquement, ou certains fichiers sont peut-être contaminés par un virus. Par conséquent, en tant qu’administrateur TFVC, vous devrez peut-être parfois détruire des fichiers et des dossiers qui sont sous gestion 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 supprimés définitivement, vous pouvez conserver l’historique qui leur est associé. Pour plus d’informations sur les options et les arguments disponibles pour tf destroy, consultez Commande Destroy (Team Foundation Version Control) .

Notes

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

Prérequis

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

  • Avant d’exécuter tf destroy sans l’option /keephistory, supprimez d’abord les fichiers que vous souhaitez détruire. Pour plus d’informations, consultez Supprimer des fichiers et des dossiers de la gestion 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.

Détruire définitivement les fichiers à version contrôlée

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

  • Pour afficher un aperçu de la destruction du fichier aFile.cs sans le détruire, entrez à l’invite de commandes :

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

    Notes

    Le texte dans 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 à 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 Oui, Non ou Oui à tout avant la suppression définitive des fichiers.

  • Pour détruire tous les fichiers dans aFolder tout en conservant leur historique, saisissez :

    tf destroy /keephistory $/MyTeamProject/aFolder

    Notes

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

    Cette action conserve les informations historiques sur tous les fichiers dans unFolder. Vous pouvez utiliser la commande tf history pour afficher l’historique d’un fichier. Vous pouvez également afficher l’historique dans l’Explorateur du contrôle de code source de 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 versionspec incluse. 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 Utiliser les commandes de contrôle de version Team Foundation.

    Pour détruire tous les fichiers du projet MyTeamProject tout en conservant l’historique des fichiers jusqu’au 23/10/2005 inclus, saisissez :

    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 géré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 dans aFolder, saisissez :

    tf destroy /startcleanup $/MyTeamProject/aFolder