Destroy-Befehl (Team Foundation-Versionskontrolle)

Der tf destroy-Befehl wird verwendet, um Dateien unter Versionskontrolle zu zerstören bzw. aus Team Foundation-Versionskontrolle dauerhaft zu löschen.

Der Zerstörungsvorgang kann nicht rückgängig gemacht werden. Zerstören Sie daher keine Dateien, die noch benötigt werden. Manchmal ist es notwendig, Versionskontrollsysteme zu bereinigen. Wenn einige Dateien beispielsweise mit einem Computervirus infiziert sind, müssen sie dauerhaft aus der Versionskontrolle entfernt werden.

Bevor Sie tf destroy ohne die /keephistory-Option ausführen, sollten Sie erst die Dateien, die Sie zerstören möchten, löschen. Weitere Informationen finden Sie unter Löschen von Dateien und Ordnern aus der Versionskontrolle.

Nachdem Sie die Dateien gelöscht haben, können Sie das Team Foundation-Warehouse synchronisieren. Andernfalls wird das Warehouse nicht mit den zerstörten Elementen synchronisiert.

Erforderliche Berechtigungen

Damit Sie den destroy-Befehl verwenden können, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren sein. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]

Parameter

Option	Beschreibungen
/keephistory	Optional. Gibt an, dass die Versionsgeschichte einer Datei beibehalten wird, auch wenn ihr Inhalt zerstört wird. Diese Option kann nicht zusammen mit der /preview-Option angegeben werden.
/stopat	Optional. Kann nur verwendet werden, wenn auch /keephistory angegeben ist. Gibt die Dateiversion der Datei (und der Dateien die darauf folgen) an, deren Versionsgeschichte erhalten bleiben soll. Die Standardversion für /stopat ist tip (T) für die letzte eingecheckte Version eines Elements. Sie können keine versionspec-Werte für Bezeichnungen oder Arbeitsbereiche verwenden, um ein Element für die /stopat-Option festzulegen.
/preview	Zeigt die Dateien, die zerstört werden würden, im Eingabeaufforderungsfenster an. Wenn tf destroy im Vorschaumodus ausgeführt wird, werden die Dateien nicht tatsächlich zerstört. Hinweis Im Eingabeaufforderungsfenster wird das Wort "Destroyed" für jede Datei angezeigt, die zerstört werden würde.Die Datei wird jedoch nicht tatsächlich zerstört, wenn die /preview-Option verwendet wird.
/startcleanup	Erzwingt den Dateiinhaltsbereinigungsprozess sofort nach dem Löschen des Inhalts. Wenn der Benutzer /startcleanup nicht angibt, wird der Bereinigungsprozess für den zerstörten Inhalt ausgeführt, wenn die Datenbankwartung alle Dateien bereinigt, auf die nicht mehr von Visual Studio Team Foundation Server verwiesen wird. Standardmäßig wird die Bereinigung einmal täglich ausgeführt.
/noprompt /i	Gibt an, dass das Löschen von Dateien nicht interaktiv ist. /i ist ein Alias für /noprompt.
/silent	Gibt an, dass beim Zerstören von Dateien oder Ordnern keine Ausgabe in das Eingabeaufforderungsfenster geschrieben wird.
/login	Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Team Foundation Server an.
/collection	Gibt die Teamprojektsammlung an.

Hinweise

Wenn Sie tf destroy verwenden, um Dateien unter Versionskontrolle zu zerstören, erhält die Anwendungsebene von Team Foundation Server die Zerstörungsanforderung und überprüft, ob Sie ein Mitglied der Sicherheitsgruppe Team Foundation-Administratoren sind. Wenn Sie kein Mitglied sind, wird ein Dialogfeld für Fehlermeldungen angezeigt, in dem darauf hingewiesen wird, dass Ihre Berechtigungen für diesen Vorgang nicht ausreichen.

Nachdem vom System ausreichende Berechtigungen festgestellt wurden, wird der Zerstörungsbefehl ausgeführt. Mit diesem Befehl werden alle Dateiverweise, Shelvesets und ausstehenden Änderungen gelöscht. Die tatsächliche Zerstörung der Dateien, die einem dauerhaften Löschen entspricht, erfolgt, wenn der Inhalt, auf den nicht mehr von Team Foundation Server verwiesen wird, das nächste Mal bereinigt wird. Sie können auch die Option /startcleanup angeben, um die Dateien sofort nach der Ausführung von tf destroy zu bereinigen.

Wenn Sie tf destroy ausführen, ohne /i und /preview anzugeben, wird vom System eine Konsolenaufforderung Yes oder No für jeden filespec-Wert angezeigt. Sie können auch Yes to all angeben. Wenn Sie die Option /keephistory nicht angeben, werden Sie von einem interaktiven Text, der Warnungen bei ausstehenden Änderungen (sofern vorhanden) ausgibt, zur Bestätigung aufgefordert. Der interaktive Text verweist auf /preview, wenn Sie weitere Informationen über die Änderungen wünschen. Wenn Sie /keephistory angeben, werden Ihnen ebenfalls Yes, No und All zur Auswahl angeboten. Wenn Sie Yes oder All auswählen, beginnt der Zerstörungsvorgang, und die Serverpfade der zerstörten Elemente werden im Eingabeaufforderungsfenster angezeigt.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...

Wenn Sie den versionspec-Wert als tip angegeben haben, werden die Serverpfade im Eingabeaufforderungsfenster mit Lösch-IDs angezeigt. Zum Beispiel könnte X123 im Eingabeaufforderungsfenster angezeigt werden.

Wenn Sie die /preview-Option angeben, werden die Dateien nicht zerstört. Im Befehlszeilentext werden jedoch die Dateien angezeigt, die zerstört werden würden. Wenn Sie z. B. in der Befehlszeile tf destroy /preview $/Test1/MyProject/MyProject/Program.cs eingeben, wird im Befehlsfenster folgender Text angezeigt:

Destroyed: $/Test1/MyProject/MyProject/Program.cs

Die Datei wird jedoch nicht tatsächlich zerstört, da die /preview-Option angegeben wurde.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".

Auswirkungen von /keephistory auf andere Versionskontrollvorgänge

Wenn Sie die /keephistory-Option angeben, um die Versionsgeschichte zerstörter Dateien beizubehalten, werden die Dateien von den folgenden Team Foundation-Versionskontrolle-Vorgängen so behandelt, als seien sie zerstört worden:

• **Inhalt ändern   **Wenn Sie versuchen, den Inhalt einer zerstörten Datei zu ändern, beispielsweise durch Bearbeiten oder Verzweigen, gibt das System eine Fehlermeldung aus, die darauf hinweist, dass der Inhalt zerstört wurde.

• **Verzweigen, Zusammenführen oder Code aufnehmen   **Wenn Sie versuchen, zerstörte Elemente zu verzweigen, zusammenzuführen oder Code darin aufzunehmen, gibt das System eine Fehlermeldung aus, die darauf hinweist, dass der Inhalt zerstört wurde.

Zerstören von vorher gelöschten Elementen

Wenn ein Element bereits gelöscht wurde, wird ihm eine Lösch-ID zugeordnet, und der Dateiname wird geändert.

Beispiele

Beschreibungen

Im folgenden Beispiel wird die Datei a.cs dauerhaft gelöscht.

Code

C:\pi\ws1>tf destroy $/proj/pi/a.cs

Beschreibungen

Im folgenden Beispiel wird der Ordner aFolder gelöscht. Geben Sie Folgendes in der Befehlszeile ein:

Code

C:\tf delete $/MyTeamProject/aFolder

Beschreibungen

Um das gelöschte Element aFolder zu zerstören, müssen Sie Folgendes in der Befehlszeile eingeben:

Code

tf destroy $/MyTeamProject/sFolder;x123

Dabei ist x123 die Lösch-ID.

Siehe auch

Aufgaben

Zerstören von Dateien unter Versionskontrolle

Konzepte

Operationen, die nur über die Befehlszeile verfügbar sind (Team Foundation-Versionskontrolle)

Weitere Ressourcen

Befehle des Befehlszeilenhilfsprogramms "Tf"