Delete, commande (Team Foundation Build)
Vous pouvez utiliser la commande delete pour supprimer une build terminée, y compris certaines ou toutes les données connexes.
Notes
Cette commande ne supprime pas les données de l'entrepôt. Pour exécuter ce genre d'opération, utilisez la commande destroy. Pour plus d'informations, consultez Destroy, commande (Team Foundation Build).
Autorisations requises
Pour exécuter la commande delete, le compte demandant l'opération de suppression doit avoir l'autorisation Supprimer les builds avec la valeur Autoriser. Si des résultats de tests sont associés à la build supprimée, le compte doit avoir l'autorisation Publier les résultats des tests avec la valeur Autoriser. En outre, le compte de service de couche Application et le compte de service Team Foundation Build doivent avoir des autorisations de lecture/écriture sur l'emplacement cible de la build. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
TFSBuild delete /collection:teamProjectCollectionUrl /builddefinition:definitionSpec buildnumber[buildNumber...] [/deleteOptions:deleteOptions] [/noprompt] [/silent] [/preview]
TFSBuild delete /collection:teamProjectCollectionUrl buildUri[buildUri...]
TFSBuild delete teamProjectCollectionUrl teamProject buildNumber[buildNumber...]
TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] /buildDefinition:definitionSpec
TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] teamProject
Paramètres
Argument |
Description |
---|---|
teamProject |
Nom du projet d'équipe pour lequel cette définition de build existe. |
definitionSpec |
Utilisé avec /builddefinition. La ou les générations que vous voulez supprimer. Les caractères génériques sont pris en charge. |
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. Les caractères génériques sont pris en charge. |
buildUri |
Une liste séparée par un espace des URI des générations que vous souhaitez supprimer. |
teamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient le build que vous voulez supprimer (par exemple, http://myserver:8080/tfs/DefaultCollection). |
deleteOptions |
Valeur fournie par l'utilisateur pour l'option /deleteOptions. Pour supprimer une build, vous pouvez spécifier une ou plusieurs des options suivantes :
|
date |
Valeur fournie par l'utilisateur pour l'option /daterange. Vous pouvez spécifier des plages de dates à l'aide de "~" comme dans les exemples suivants :
|
Option |
Description |
---|---|
/noprompt |
N'effectuez pas d'invite lorsque vous supprimez une build. |
/silent |
N'écrivez pas la sortie dans la fenêtre Invite de commandes lors de la suppression. Implique /noprompt. |
/builddefinition |
Spécifie la ou les définitions de build que vous souhaitez supprimer. |
/collection |
Spécifie la collection du projet d'équipe. |
/deleteOptions |
Spécifie les options de suppression d'un build. |
/preview |
Affiche ce qui se produirait sans exécuter réellement l'opération delete. |
/daterange |
Spécifie la plage de dates des builds que vous voulez supprimer. |
Notes
Processus de suppression
Si une défaillance se produit pendant ce processus, un message d'avertissement s'affiche. Toutefois, même si un avertissement s'affiche, la suppression est considérée comme réussie.
Builds multiples supprimées
Si vous spécifiez plusieurs builds, un échec de suppression de l'une des builds n'arrête pas le processus. La commande poursuit la suppression des autres builds après avoir généré un message d'erreur d'échec de suppression de build.
Journal des événements
Les suppressions de builds sont enregistrées dans le journal des événements. Le journal disposera d'informations sur la personne qui a supprimé la build, l'heure à laquelle la build a été supprimée et le numéro de build.
Exemple
L'exemple suivant supprime deux builds définies par les numéros de build "TestBuild1 1_20070510.1" et "TestBuild 1_20070510.2" du projet d'équipe AdventureWorks dans la collection de projets d'équipe à l'adresse http://myserver:8080/tfs/DefaultCollection.
> > tfsbuild.exe delete http://myserver:8080/tfs/DefaultCollection Adventureworks "TestBuild1 1_20070510.1" "TestBuild 1_20070510.2"
L'exemple suivant supprime deux builds spécifiques dans lesquels le paramètre definitionSpec est "\Adventureworks\Definition1" du projet d'équipe AdventureWorks dans la collection de projets d'équipe à l'adresse http://myserver:8080/tfs/DefaultCollection.
>tfsbuild.exe delete /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"\Adventureworks\Definition 1" "Definition 1_20070510.1" "Definition 1_20070510.2"
L'exemple suivant supprime deux builds définies par les URI de build "vstfs:///TestBuild/TestBuild/1" et "vstfs:///TestBuild/TestBuild/2" du projet d'équipe AdventureWorks dans la collection de projets d'équipe à l'adresse http://myserver:8080/tfs/DefaultCollection.
>tfsbuild.exe delete /collection:http://myserver:8080/tfs/DefaultCollection vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29