Freigeben über


Befehl "Destroy" (Team Foundation Build)

Sie können fertig gestellte Builds mithilfe des TFSBuild destroy-Befehls permanent zerstören. Sie können im Data Warehouse Speicherplatz sparen, indem Sie veraltete fertig gestellte Builds zerstören.

Warnung

Verwenden Sie diesen Befehl vorsichtig, da Sie seine Auswirkung nicht rückgängig machen können.

Dieser Befehl löscht den Datenbankdatensatz für einen Build permanent, aber keine buildbezogenen Artefakte, z. B. Ablagen, Versionskontrollbezeichnungen und Testergebnisse. Sie können Artefakte mithilfe des TFSBuild delete-Befehls löschen, bevor Sie den Build permanent zerstören.

Erforderliche Berechtigungen

Damit Sie den Befehl destroy verwenden können, müssen Sie über die Berechtigung Builds zerstören verfügen. Administratoren von Teamprojektauflistungen, Projektadministratoren und Generatoren wird diese Berechtigung automatisch zugewiesen. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

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...]

Parameter

Argument

Beschreibungen

TeamProjectCollectionUrl

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

DefinitionSpec

Wird mit /BuildDefinition verwendet. Die Builddefinitionen, die zerstört werden sollen. Sie können Platzhalterzeichen verwenden.

BuildNumber

Eine durch Leerzeichen getrennte Liste des bzw. der Builds, die Sie zerstören möchten. Wenn die Buildnummer Leerzeichen enthält, setzen Sie die Nummer in einfache Anführungszeichen. Sie können Platzhalterzeichen verwenden.

BuildUri

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

TeamProject

Teamprojektname, für den diese Builddefinition vorhanden ist.

Date

Wird für die /daterange-Option verwendet. Ein Datum in irgendeinem Format, das .NET Framework analysieren kann. 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

/collection

Gibt die Teamprojektsammlung an.

/BuildDefinition

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

/preview

Zeigt die Builds, die zerstört werden würden, im Eingabeaufforderungsfenster an. Wenn Sie diese Option angeben, werden die Builds nicht tatsächlich zerstört.

/noprompt

Gibt an, dass keine Bestätigung beim Löschen eines Builds angezeigt wird.

/silent

Gibt an, dass keine Ausgabe in das Eingabeaufforderungsfenster geschrieben wird, während Builds gelöscht werden. Impliziert /noprompt.

Hinweise

Wenn Sie versuchen, einen Build ohne die entsprechende Berechtigung zu zerstören, informiert Sie über diesen Fakt ein Dialogfeld.

Beispiel

Im folgenden Beispiel werden Builds von vor dem 20. November 2010 permanent zerstört, die auf der Builddefinition "Nightly Build" im Teamprojekt "New Works" basieren.

>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20

Siehe auch

Aufgaben

Löschen eines abgeschlossenen Builds

Erstellen einer einfachen Builddefinition

Weitere Ressourcen

Team Foundation Build-Befehle

Ausführen und Überwachen von Builds

Definieren des Buildprozesses