Delete, commande (Team Foundation Build)

Article
08/22/2008

Mise à jour : novembre 2007

La commande delete supprime une build terminée spécifiée. Toutes les données relatives à la build sont supprimées de la contrôle de version et de l'agent de build, et l'emplacement cible est effacé. En outre, la build n'est plus répertoriée dans l'Explorateur de builds.

Autorisations requises

Pour exécuter la commande delete, le compte demandant l'opération de suppression doit avoir l'autorisation Administrer une build 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.

Remarque :
Même si vous êtes connecté en tant qu'administrateur, vous devez ouvrir une invite de commandes avec autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une invite de commandes avec autorisations élevées, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez le site Web de Microsoft (en anglais).

Même si vous êtes connecté en tant qu'administrateur, vous devez ouvrir une invite de commandes avec autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une invite de commandes avec autorisations élevées, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez le site Web de Microsoft (en anglais).

TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer /builddefinition:definitionSpec buildNumbers…

TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer buildUris…

TFSBuild delete [/noprompt] [/silent] teamFoundationServer teamProject buildNumbers…

Paramètres

Argument	Description
teamfoundationserver	URL du serveur Team Foundation utilisée pour les builds.
teamProject	Nom du projet d'équipe pour lequel cette définition de build existe.
definitionSpec	Utilisé avec /builddefinition. Build(s) qui sera/seront supprimée(s). Les caractères génériques sont pris en charge.
BuildNumbers	Liste séparée par des espaces de la/les build(s) qui sera/seront supprimée(s). Si le numéro de build comprend des espaces, mettez-le entre guillemets simples. Les caractères génériques sont pris en charge.
buildUris	Liste séparée par des espaces des URI de build qui doivent être supprimées. Par exemple, tfsbuild delete uri1 uri2 uri3 /s:MyServer.

Option	Description
/noprompt	Facultatif. N'affichez pas d'invite lors de la suppression d'une build.
/silent	Facultatif. N'écrivez pas la sortie dans la fenêtre d'invite de commandes lors de la suppression. Implique /noprompt.
/server	Serveur Team Foundation utilisé pour la/les build(s) à supprimer.
/builddefinition	Spécifie la/les définition(s) de build à supprimer.

Notes

Processus de suppression

Lorsque vous supprimez un numéro de build, suivez ces étapes :

Vérifiez que le numéro de build est valide et que la build n'est pas en cours.
Supprimez le contenu du magasin de générations et du site cible si le demandeur dispose de l'autorisation Administrer la build.
Effacez l'emplacement cible des fichiers binaires de cette build. Si un échec se produit pendant ce processus, un message d'avertissement s'affiche. Toutefois, même avec l'avertissement, la suppression est considérée réussie.

Remarque :

Aucune donnée n'est supprimée de l'entrepôt.

Remarque :
Aucune donnée n'est supprimée de l'entrepôt.

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 fourni 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 illustre la suppression de deux builds définies par les numéros de build « TestBuild1 1_20070510.1 » et « TestBuild 1_20070510.2 » du projet d'équipe AdventureWorks sur server01.

> > tfsbuild.exe delete http://server01:8080 Adventureworks “TestBuild1 1_20070510.1” “TestBuild 1_20070510.2”

L'exemple suivant illustre la suppression de deux builds spécifiques où le definitionSpec est « \Adventureworks\Definition1 » du projet d'équipe AdventureWorks sur server01.

>tfsbuild.exe delete /server:http://server01:8080 /builddefinition:”\Adventureworks\Definition 1” “Definition 1_20070510.1” “Definition 1_20070510.2”

L'exemple suivant illustre la suppression de deux builds définies par les URI de build « TestBuild1 1_20070510.1 » et « TestBuild 1_20070510.2 » du projet d'équipe AdventureWorks sur server01.

>tfsbuild.exe delete /server:http://server01:8080 vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29

Voir aussi

Tâches

Comment : supprimer une build terminée (ligne de commande)

Comment : créer une définition de build

Autres ressources

Commandes de Team Foundation Build

Exécution de builds dans Team Foundation Build

Utilisation de définitions de build dans Team Foundation Build

Partager via