Freigeben über

Befehl "Delete" (Team Foundation Build)

  • Artikel

Sie können den delete-Befehl verwenden, um einen abgeschlossenen Build zu löschen, einschließlich einiger oder aller verknüpfter Daten.

Tipp

Dieser Befehl löscht keine Daten aus dem Warehouse; um diese Art von Vorgang auszuführen, verwenden Sie den Befehl destroy. Weitere Informationen finden Sie unter Befehl "Destroy" (Team Foundation Build).

Erforderliche Berechtigungen

Zum Ausführen des delete-Befehls muss für das Konto, von dem der Löschvorgang angefordert wird, die Berechtigung Builds löschen auf Zulassen festgelegt sein. Wenn dem zu löschenden Build Testergebnisse zugeordnet sind, muss für das Konto die Berechtigung Testergebnisse veröffentlichen auf Zulassen festgelegt sein. Zusätzlich werden für das Dienstkonto auf Anwendungsebene und das Team Foundation Build-Dienstkonto Lese-/Schreibberechtigungen für den Ablagespeicherort des Builds benötigt. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

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

Parameter

Argument

Beschreibungen

teamProject

Teamprojektname, für den diese Builddefinition vorhanden ist.

definitionSpec

Wird mit /builddefinition verwendet. Der Build oder die Builds, die gelöscht werden sollen. Platzhalterzeichen werden unterstützt.

buildNumber

Eine durch Leerzeichen getrennte Liste des bzw. der Builds, die Sie löschen möchten. Wenn die Buildnummer Leerzeichen enthält, setzen Sie die Nummer in einfache Anführungszeichen. Platzhalterzeichen werden unterstützt.

buildUri

Eine durch Leerzeichen getrennte Liste der URIs bzw. der Builds, die Sie löschen möchten.

teamProjectCollectionUrl

Die URL der Teamprojektauflistung, die den Build enthält, den Sie löschen möchten (z. B. http://myserver:8080/tfs/DefaultCollection).

deleteOptions

Der Wert, den der Benutzer für die Option /deleteOptions angibt. Wenn Sie einen Build löschen möchten, können Sie eine oder mehrere der folgenden Optionen angeben:

  • DropLocation – löscht den Ablagespeicherort des Builds.

  • TestResults – löscht die Testergebnisse für den Build.

  • Bezeichnung – löscht die Versionskontrollbezeichnung, die vom Build erstellt wurde.

  • Details – löscht die Details (z. B. Aktivitätsprotokoll) der Builds.

  • Symbole – löscht jede Symboldatei (* .pdb) im Symbolspeicher, der dem Build zugeordnet ist.

  • Alles – löscht alle Daten, die dem Build zugeordnet sind.

    HinweisHinweis
    Sie können die Optionen durch Kommas trennen.Beispielsweise können Sie die Ablage und die Symbole eines Builds mit "/deleteOptions: DropLocation, Symbols" löschen.

date

Der vom Benutzer angegebene Wert für die /daterange-Option. Sie können Datumsbereiche mit einem "~" angeben, wie im folgenden Beispiel gezeigt:

  • ~1/1/2010 – alle Builds, die vor 1.1.2010 erstellt wurden

  • 1/1/2010~ – alle Builds, die nach 1.1.2010 erstellt wurden

  • 1/1/2009~12/31/2009 – alle Builds, die zwischen 1.1.2009 und 31.12.2009 erstellt wurden

Option

Beschreibungen

/noprompt

Es wird keine Meldung beim Löschen eines Builds angezeigt.

/silent

Keine Ausgabe in das Eingabeaufforderungsfenster während des Löschens schreiben. Impliziert /noprompt.

/builddefinition

Gibt die Builddefinition oder -definitionen an, die gelöscht werden sollen.

/collection

Gibt die Teamprojektsammlung an.

/deleteOptions

Gibt die Optionen für das Löschen eines Builds an.

/preview

Zeigt das Ergebnis an, ohne dass der delete-Vorgang tatsächlich ausgeführt wird.

/daterange

Gibt den Datumsbereich der Builds an, die gelöscht werden sollen.

Hinweise

Löschvorgang

Wenn während dieses Prozesses ein Fehler auftritt, wird eine Warnmeldung angezeigt. Auch bei Anzeige einer Warnung wird der Löschvorgang als erfolgreich eingestuft.

Löschen mehrerer Builds

Wenn mehrere Builds angegeben werden und beim Löschen eines der Builds ein Fehler auftritt, wird der Prozess dadurch nicht beendet. Durch den Befehl wird der Löschvorgang der anderen Builds fortgeführt, nachdem eine Meldung zu dem fehlgeschlagenen Löschvorgang ausgegeben wurde.

Ereignisprotokoll

Buildlöschvorgänge werden im Ereignisprotokoll protokolliert. Das Protokoll enthält Informationen zum Benutzer, der den Build gelöscht hat, zum Löschzeitpunkt des Builds sowie zur Buildnummer.

Beispiel

Im folgenden Beispiel werden zwei Builds mit den Buildnummern "TestBuild1 1_20070510.1" und "TestBuild 1_20070510.2" aus dem AdventureWorks-Teamprojekt in der Teamprojektauflistung unter http://myserver:8080/tfs/DefaultCollection entfernt.

> > tfsbuild.exe delete http://myserver:8080/tfs/DefaultCollection Adventureworks "TestBuild1 1_20070510.1" "TestBuild 1_20070510.2"

Im folgenden Beispiel werden zwei bestimmte Builds entfernt, wobei die definitionSpec "\Adventureworks\Definition1" aus dem AdventureWorks-Teamprojekt in der Teamprojektauflistung unter http://myserver:8080/tfs/DefaultCollection ist.

>tfsbuild.exe delete /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"\Adventureworks\Definition 1" "Definition 1_20070510.1" "Definition 1_20070510.2"

Im folgenden Beispiel werden zwei Builds mit den Build-URIs "vstfs:///TestBuild/TestBuild/1" und "vstfs:///TestBuild/TestBuild/2" aus dem AdventureWorks-Teamprojekt in der Teamprojektauflistung unter http://myserver:8080/tfs/DefaultCollection entfernt.

>tfsbuild.exe delete /collection:http://myserver:8080/tfs/DefaultCollection vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29

Siehe auch

Aufgaben

Löschen eines abgeschlossenen Builds

Weitere Ressourcen

Befehl "Destroy" (Team Foundation Build)