Zerstören von Dateien unter Versionskontrolle

Mit der Zeit wird auf einem Versionskontrollserver eine wachsende Anzahl von Dateien und Ordnern abgelegt. Dies kann bei der Verwaltung des Speicherplatzbedarfs Probleme verursachen. Es kann notwendig werden, sämtliche Teamprojekte und deren Hierarchien aus der Versionskontrolle zu entfernen. Möglicherweise wurde ein Teamprojekt nur zu Übungszwecken angelegt, oder Dateien sind mit einem Virus infiziert. Daher muss ein Team Foundation-Administrator gelegentlich Dateien und Ordner zerstören, die sich unter Versionskontrolle befinden.

Im folgenden Verfahren wird dargestellt, wie Dateien und Ordner mit dem tf destroy-Befehl zerstört werden. Obwohl die Dateien dauerhaft entfernt werden, kann die ihnen zugeordnete Versionsgeschichte erhalten werden. Weitere Informationen über die für tf destroy verfügbaren Optionen und Argumente finden Sie unter Destroy-Befehl (Team Foundation-Versionskontrolle).

Erforderliche Berechtigungen

Zum Verwenden des destroy-Befehls müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Voraussetzungen zur Ausführung von tf destroy

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 eine Datei gelöscht wurde, enthält ihr Name eine Lösch-ID. Ist der Dateiname beispielsweise aFile.cs, wird er nach dem Löschen in aFile.cs;x123 geändert, wobei x123 die Lösch-ID ist.

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.

So zerstören Sie Dateien unter Versionskontrolle dauerhaft

• Klicken Sie auf Start und dann nacheinander auf Alle Programme, Microsoft Visual Studio 2008, Visual Studio Tools und Visual Studio-Eingabeaufforderung.

  • Um die Datei aFile.cs in der Vorschau anzuzeigen, ohne sie zu zerstören, geben Sie Folgendes an der Eingabeaufforderung ein:

    >tf destroy /preview /i $/MyTeamProject/aFile.cs
    

    Tipp

    In der Eingabeaufforderung wird "Destroyed: $/MyTeamProject/aFile.cs" angezeigt. Die Datei wird jedoch bei der Verwendung der /preview-Option nicht tatsächlich zerstört.

  • Um die Datei aFile.cs zu zerstören, geben Sie Folgendes an der Eingabeaufforderung ein:

    >tf destroy /i $/MyTeamProject/aFile.cs
    

    Von diesem Befehl werden Informationen über mögliche ausstehende Änderungen und Shelvesets im Eingabeaufforderungsfenster angezeigt. Da /i (nicht interaktiv) angegeben wurde, wird nicht mit einem Dialogfeld Yes, No, Yes to all nachgefragt, bevor die Dateien dauerhaft entfernt werden.

  • Um alle Dateien in aFolder zu zerstören und gleichzeitig ihre Versionsgeschichte zu erhalten, geben Sie Folgendes ein:

    >tf destroy /keephistory $/MyTeamProject/aFolder
    

    Tipp

    /preview kann nicht zusammen mit /keephistory angegeben werden.

    Bei dieser Aktion bleiben die Versionsinformationen aller Dateien in aFolder erhalten. Sie können den Befehl tf history verwenden, um die Versionsgeschichte einer Datei anzuzeigen. Sie können die Versionsgeschichte auch im Quellcodeverwaltungs-Explorer anzeigen. Weitere Informationen finden Sie unter Befehl History und unter Anzeigen von Daten zur Versionsgeschichte.

  • Verwenden Sie die /stopat-Option, um die Versionsinformationen bis einschließlich eines versionSpec-Werts zu erhalten. Der versionSpec-Wert kann die neueste Version, ein bestimmtes Changeset oder ein Datum sein. Weitere Informationen zu versionspec-Werten finden Sie unter Befehlszeilensyntax (Versionskontrolle).

    Um alle Dateien des Teamprojekts MyTeamProject zu zerstören und gleichzeitig die Versionsgeschichte der Dateien bis einschließlich des 23.10.2005 zu erhalten, geben Sie Folgendes ein:

    >tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005
    

  • Verwenden Sie die /startcleanup-Option, um den Inhalt, auf den nicht mehr von Team Foundation Server verwiesen wird, sofort zu bereinigen. Ohne diese Option werden die zerstörten Dateien entfernt, wenn die Datenbank von einem SQL-Prozess verwaltet wird, der im Allgemeinen einmal am Tag ausgeführt wird.

    Um sofort alle Dateien in aFolder zu zerstören, geben Sie Folgendes ein:

    >tf destroy /startcleanup $/MyTeamProject/aFolder
    

Siehe auch

Aufgaben

Verschieben, Umbenennen und Löschen von Dateien und Ordnern unter Versionskontrolle

Referenz

Destroy-Befehl (Team Foundation-Versionskontrolle)

Konzepte

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

Weitere Ressourcen

Befehlszeilenreferenz der Team Foundation-Versionskontrolle