Destroy, commande (contrôle de version Team Foundation)
Utilisez la commande tf destroy pour détruire ou supprimer définitivement les fichiers sous contrôle de version du contrôle de version Team Foundation.
L'action de destruction ne peut pas être inversée. Vous ne devez pas détruire les fichiers encore nécessaires. Vous devrez parfois nettoyer les systèmes de contrôle de version. Par exemple, si certains fichiers sont infectés par un virus informatique, vous devez les supprimer définitivement du contrôle de version.
Avant d'exécuter tf destroy sans l'option /keephistory, nous vous recommandons de supprimer auparavant 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é les fichiers, vous pouvez synchroniser l'entrepôt Team Foundation. Sinon, ce dernier ne sera pas synchronisé avec les éléments détruits.
Autorisations requises
Pour utiliser la commande destroy, vous devez appartenir au groupe de sécurité Team Foundation Administrators. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>]
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]
Paramètres
Argument |
Description |
|---|---|
itemspec1 [itemspec2…itemspecN] |
Spécifie le chemin d'accès au serveur du fichier ou du dossier à détruire. Utilisez plusieurs valeurs itemspec pour supprimer plusieurs éléments. Par exemple, tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3. Les chemins d'accès locaux ne sont pas pris en charge. |
versionspec |
Fournit une version telle que C58 pour les options /keephistory ou /stopat. Les valeurs autorisées sont date, tip ou un ensemble de modifications spécifique. Pour plus d'informations sur la façon dont Team Foundation analyse une spécification de version afin de déterminer quels éléments se trouvent dans sa portée, consultez Syntaxe de ligne de commande (Contrôle de version). |
username |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
TeamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient des fichiers que vous voulez supprimer (par exemple, http://myserver:8080/tfs/DefaultCollection). |
Option |
Description |
|---|---|
/keephistory |
Facultatif. Spécifie que l'historique d'un fichier est conservé même lorsque son contenu est détruit. Cela ne peut pas être spécifié avec l'option /preview. |
/stopat |
Facultatif. Ne peut être utilisé que si /keephistory est également spécifié. Spécifie la version de fichier pour le fichier, et les fichiers qui s'ensuivent, pour lesquels l'historique est conservé. La version par défaut pour /stopat est tip (T) pour la version d'un élément archivée en dernier. Vous ne pouvez pas utiliser de valeurs d'étiquette ou d'espace de travail versionspec pour spécifier un élément pour l'option /stopat. |
/preview |
Affiche dans la fenêtre Invite de commandes les fichiers qui seraient détruits. Lorsque tf destroy s'exécute en mode Aperçu, les fichiers ne sont pas réellement détruits. .gif "Remarque") Remarque
Le texte de la fenêtre Invite de commandes affiche le mot "Détruit" avec chaque fichier qui serait détruit.Toutefois, le fichier n'est pas réellement détruit lorsque l'option /preview est utilisée.
|
/startcleanup |
Force le démarrage immédiat du processus de nettoyage du contenu du fichier après la fin de la suppression du contenu. Si l'utilisateur ne spécifie pas /startcleanup, le processus de nettoyage du contenu détruit se produit lorsque la maintenance de la base de données nettoie tous les fichiers qui ne sont plus référencés par Visual Studio Team Foundation Server. Par défaut, le nettoyage est planifié pour s'exécuter une fois par jour. |
/noprompt /i |
Spécifie que la destruction de fichiers est non interactive. /i est un alias de /noprompt. |
/silent |
Indique que, lorsque vous supprimez des fichiers ou dossiers, la sortie n'est pas écrite dans la fenêtre d'invite de commandes. |
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Team Foundation Server. |
/collection |
Spécifie la collection du projet d'équipe. |
Notes
Lorsque vous utilisez tf destroy pour détruire des fichiers sous contrôle de version, la couche Application de Team Foundation Server reçoit la demande de destruction et vérifie si vous êtes membre du groupe de sécurité Team Foundation Administrators. Si vous n'êtes pas membre, le système affiche une boîte de dialogue de message d'erreur qui vous informe que vous n'avez pas les autorisations suffisantes pour effectuer l'opération.
Après que le système a vérifié vos autorisations, il exécute la commande destroy. Cette commande supprime toutes les références de fichier, jeux de réservations et modifications en attente. La destruction réelle de fichiers, qui est une suppression permanente, se produit au prochain nettoyage du contenu qui n'est plus référencé par Team Foundation Server. Vous pouvez également spécifier l'option /startcleanup pour nettoyer les fichiers immédiatement après l'exécution de tf destroy.
Si vous exécutez tf destroy sans spécifier /i et /preview, le système affiche une console Yes ou une invite No pour chaque valeur filespec. Sinon, vous pouvez spécifier Yes to all. Si vous ne spécifiez pas /keephistory, vous y êtes invité par un texte interactif qui vous avertit des modifications en attente, le cas échéant. Le texte interactif pointe vers /preview si vous souhaitez plus d'informations sur les modifications. Si vous spécifiez /keephistory, vous êtes également invité par le texte Yes, No ou All. Si vous sélectionnez Yes ou All, le processus de destruction démarre et les chemins d'accès au serveur des éléments détruits apparaissent dans la fenêtre Invite de commandes.
Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...
Si vous avez spécifié la valeur versionspec en tant que tip, les chemins d'accès au serveur affichés dans la fenêtre Invite de commandes incluent les ID de suppression. Par exemple, X123 peut apparaître dans la fenêtre Invite de commandes.
Si vous utilisez l'option /preview, les fichiers ne sont pas détruits, mais le texte de ligne de commande affiche les fichiers qui le seraient. Par exemple, si, à la ligne de commande, vous tapez tf destroy /preview $/Test1/MyProject/MyProject/Program.cs, la fenêtre de commande affiche le texte suivant :
Détruit : $/Test1/MyProject/MyProject/Program.cs
Toutefois, le fichier n'est pas réellement détruit parce que vous avez utilisé l'option /preview.
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.
Effets de /keephistory sur d'autres opérations de contrôle de version
Si vous spécifiez l'option /keephistory pour conserver l'historique des fichiers détruits, les fichiers sont traités comme détruits par les opérations contrôle de version Team Foundation suivantes :
**Modification de contenu **Si vous tentez de modifier le contenu d'un fichier détruit, par exemple de modifier ou de créer une branche, le système génère un message d'erreur qui indique que le contenu a été détruit.
**Création de branche, fusion ou déréservation **Si vous tentez de créer une branche, d'effectuer une fusion ou une déréservation, le système génère un message d'erreur qui indique que le contenu des éléments a été détruit.
Destruction d'éléments préalablement supprimés
Si un élément a déjà été supprimé, un ID de suppression lui est associé et entraîne une modification de nom de fichier.
Exemples
Description
L'exemple suivant supprime définitivement le fichier a.cs.
Code
C:\pi\ws1>tf destroy $/proj/pi/a.cs
Description
L'exemple suivant supprime un dossier, aFolder, tapez sur la ligne de commande :
Code
C:\tf delete $/MyTeamProject/aFolder
Description
Pour détruire l'élément supprimé, aFolder, vous devez taper sur la ligne de commande :
Code
tf destroy $/MyTeamProject/sFolder;x123
Où x123 est l'ID de suppression.
Voir aussi
Tâches
Détruire les fichiers ayant fait l'objet d'un contrôle de version