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:
|
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