Destroy, commande (Team Foundation Build)
Vous pouvez utiliser la commande TFSBuild destroy pour supprimer les builds terminés définitivement. En supprimant les builds terminées obsolètes, vous pouvez gagner de l'espace dans votre entrepôt de données.
Avertissement
Utilisez cette commande avec précaution car vous ne pouvez pas annuler cet effet.
Cette commande supprime définitivement l'enregistrement de base de données pour une build, mais elle ne supprime pas les artefacts associés à la build, tels que des suppressions, des étiquettes de contrôle de version et des résultats de test. Vous pouvez utiliser la commande TFSBuild delete pour supprimer des artefacts avant de supprimer le build de manière définitive.
Autorisations requises
Pour utiliser la commande destroy, vous devez disposer du jeu d'autorisations Détruire les builds avec la valeur Autoriser. Cette autorisation est automatiquement donnée aux administrateurs de collections de projets d'équipe, aux administrateurs de projet et aux générateurs. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
TFSBuild destroy /collection:TeamProjectCollectionUrl /BuildDefinition:DefinitionSpec BuildNumber [BuildNumber...] [/noprompt] [/silent] [/preview]
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
TFSBuild destroy TeamProjectCollectionUrl TeamProject BuildNumber [BuildNumber...]
TFSBuild destroy /collection:TeamProjectCollectionUrl /DateRange: [Date]~[Date] /BuildDefinition:DefinitionSpec
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
Paramètres
Argument |
Description |
|---|---|
TeamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient le build que vous voulez supprimer (par exemple, http://myserver:8080/tfs/DefaultCollection). |
DefinitionSpec |
Utilisé avec /BuildDefinition. Définitions de build que vous voulez supprimer. Vous pouvez utiliser des caractères génériques. |
BuildNumber |
Une liste séparée par un espace des générations que vous souhaitez supprimer. Si le numéro de build a des espaces, mettez le nombre entre des guillemets simples. Vous pouvez utiliser des caractères génériques. |
BuildUri |
Une liste séparée par un espace des URI des générations que vous souhaitez supprimer. |
TeamProject |
Nom du projet d'équipe pour lequel cette définition de build existe. |
Date |
Utilisé pour l'option /daterange. Une date dans un format quelconque que .NET Framework peut analyser. Vous pouvez spécifier des plages de dates à l'aide de "~" comme dans les exemples suivants :
|
Option |
Description |
|---|---|
/collection |
Spécifie la collection du projet d'équipe. |
/BuildDefinition |
Spécifie la ou les définitions de build que vous souhaitez supprimer. |
/preview |
Affiche dans la fenêtre Invite de commandes les builds devant être détruites. Lorsque vous spécifiez cette option, les builds ne sont pas réellement supprimés. |
/noprompt |
Permet de ne pas vous inviter à confirmer quand vous supprimez un build. |
/silent |
Permet de ne pas écrire la sortie dans la fenêtre d'invite de commandes pendant la suppression des builds. Implique /noprompt. |
Notes
Si vous essayez de supprimer une génération sans autorisation appropriée, une boîte de dialogue vous en informe.
Exemple
L'exemple suivant supprime de manière permanente les builds dont la date est antérieure au 20 novembre 2010, et qui sont basées sur la définition de build "Nightly Build" dans le projet d'équipe "New Works" (Nouveaux travaux).
>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20
Voir aussi
Tâches
Créer une définition de build de base
Autres ressources
Commandes de Team Foundation Build