Freigeben über

Löschen von versionsgesteuerten Dateien

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Im Laufe der Zeit erwirbt ein Versionsverwaltungsserver eine wachsende Anzahl von Dateien und Ordnern. Dies kann zu Problemen führen, wenn Sie versuchen, speicherplatzanforderungen zu verwalten. Möglicherweise müssen Sie alle Projekte und deren Hierarchien aus der Versionssteuerung entfernen. Beispielsweise kann ein Projekt nur zu Lernzwecken erstellt werden, oder vielleicht sind einige Dateien mit einem Virus kontaminiert. Daher müssen Sie als TFVC-Administrator gelegentlich Dateien und Ordner zerstören, die der Versionskontrolle unterliegen.

Das folgende Verfahren zeigt, wie Sie Dateien und Ordner mithilfe des Befehls tf destroy zerstören. Obwohl die Dateien dauerhaft entfernt werden, können Sie den ihnen zugeordneten Verlauf beibehalten. Weitere Informationen zu den Optionen und Argumenten, die für tf destroy verfügbar sind, finden Sie unter Destroy-Befehl (Team Foundation-Versionskontrolle).

Anmerkung

Der Vorgang destroy ist nur über die Befehlszeile verfügbar.

Voraussetzungen

  • Um den Befehl destroy zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation Administratoren sein. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

  • Bevor Sie tf destroy ohne die Option /keephistory ausführen, löschen Sie zuerst die Dateien, die Sie zerstören möchten. Weitere Informationen finden Sie unter Löschen von Dateien und Ordnern aus der Versionssteuerung. Nachdem Sie eine Datei gelöscht haben, enthält der Dateiname jetzt eine Lösch-ID. Wenn beispielsweise ein Dateiname aFile.csist, wird der Dateiname nach dem Löschen aFile.cs; x123, wobei x123 die Lösch-ID ist.

    Nachdem Sie die Dateien gelöscht haben, können Sie das TFVC-Lager synchronisieren. Andernfalls wird das Lager nicht mit den zerstörten Artikeln synchronisiert.

So zerstören Sie versionsgesteuerte Dateien dauerhaft

Wählen Sie in Windows Start aus, und geben Sie dann Developer-Eingabeaufforderung ein. Wählen Sie in den Suchergebnissen die Entwickler-Eingabeaufforderung für Ihre Visual Studio-Version aus, z. B. Entwickler-Eingabeaufforderung für Visual Studio 2022.

  • Geben Sie an der Eingabeaufforderung Folgendes ein, um das Zerstören der Datei aFile.cs in der Vorschau anzuzeigen, ohne sie tatsächlich zu zerstören:

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

    Anmerkung

    Der Text im Eingabeaufforderungsfenster zeigt Destroyed: $/MyTeamProject/aFile.csan, die Datei wird jedoch nicht tatsächlich zerstört, wenn Sie die Option /preview verwenden.

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

    tf destroy /i $/MyTeamProject/aFile.cs

    Dieser Befehl zeigt Informationen zu möglichen ausstehenden Änderungen und Shelvesets im Eingabeaufforderungsfenster an. Wenn Sie /i oder „nicht interaktiv“ angeben, werden Sie nicht mit einem Dialogfeld Ja, Nein oder Ja für Alle zu einer Bestätigung aufgefordert, bevor Dateien endgültig entfernt werden.

  • Um alle Dateien in aFolder zu löschen und gleichzeitig ihre Historie beizubehalten, geben Sie Folgendes ein:

    tf destroy /keephistory $/MyTeamProject/aFolder

    Anmerkung

    Sie können nicht /preview mit /keephistory angeben.

    Diese Aktion behält die Verlaufsinformationen zu allen Dateien in aFolder bei. Mit dem Befehl tf history können Sie den Verlauf einer Datei anzeigen. Sie können den Verlauf auch im Quellcodeverwaltungs-Explorer in Visual Studio anzeigen. Weitere Informationen finden Sie unter Verlaufsbefehl und Abrufen des Verlaufs eines Elements.

  • Verwenden Sie die Option /stopat, um die historischen Informationen bis einschließlich einem versionspec-Wert beizubehalten. Der versionspec Wert kann die neueste Version, ein bestimmtes Änderungsset oder ein Datum sein. Weitere Informationen zu versionspec-Werten finden Sie unter Verwenden von Befehlen der Team Foundation-Versionssteuerung.

    Um alle Dateien im Projekt MyTeamProject zu zerstören und gleichzeitig den Dateiverlauf bis einschließlich 23.10.2005 beizubehalten, geben Sie Folgendes ein:

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

  • Verwenden Sie die /startcleanup Option, um die TFVC-Metadaten der Dateien sofort zu bereinigen, auf die nicht mehr durch Azure DevOps Server verwiesen wird. Ohne diese Option werden diese Metadaten entfernt, wenn die Datenbank von einem SQL-Prozess verwaltet wird, der alle fünf Tage ausgeführt wird. Sieben Tage nach dem Löschen der TFVC-Metadaten werden die Inhalte der zerstörten Dateien von einem anderen SQL-Prozess gelöscht.

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

    tf destroy /startcleanup $/MyTeamProject/aFolder