Löschen eines Projekts

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

Wenn ein Projekt veraltet ist, können Sie es aus Ihrer Organisation oder Sammlung in Azure DevOps löschen. Ebenso kann es erforderlich sein, das Projekt zu löschen, wenn Sie von einem lokalen Azure DevOps Server zu Azure DevOps Services migrieren. Das Entfernen von Projekten kann auch die Navigation verbessern, indem sie nur auf die Projekte beschränkt wird, die derzeit verwendet werden.

Voraussetzungen

Speichern von Projektdaten

Verwenden Sie die folgenden Verfahren, um Daten zu speichern, die Benutzern am wichtigsten sind, z. B. Quellcode, Builddaten und Arbeitsaufgaben. Dieses Verfahren ist optional, und sie können sie berücksichtigen, bevor Sie ein Projekt löschen.

• Quellcode und benutzerdefinierte Buildvorlagen: Laden Sie Ihre Dateien als ZIP-Datei herunter. Wählen Sie für das Repository, die Datei oder den Ordner aus, und wählen Sie "Als ZIP herunterladen" aus. Oder wählen Sie "Herunterladen " aus, um entweder alle Dateien im aktuell ausgewählten Ordner oder die aktuell ausgewählte Datei herunterzuladen.

  

  Dieser Vorgang speichert keinen Änderungsverlauf oder Links zu anderen Artefakten. Wenn Sie Git verwenden, klonen Sie Ihre Repositorys, um den vollständigen Projektverlauf und alle Verzweigungen beizubehalten.

• Builddaten: Informationen zum Speichern von Protokollen und Daten in Den Drop-Buildordnern finden Sie unter Anzeigen von Buildergebnissen.

• Daten zur Nachverfolgung von Arbeitsaufgaben: Erstellen Sie eine Arbeitsaufgabenabfrage, und öffnen Sie sie mit Excel. Speichern Sie die Excel-Tabelle.

  Bei diesem Vorgang werden keine Anlagen, Änderungen des Verlaufs oder Links zu anderen Artefakten gespeichert.

Weitere Informationen finden Sie in unserer Datenschutzübersicht.

az devops project delete --id
                         [--org]
                         [--yes] 

az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes

Wiederherstellen eines gelöschten Projekts

Wenn Sie ein Projekt versehentlich in Azure DevOps löschen, können Sie es innerhalb von 28 Tagen nach dem Löschen wiederherstellen.

Projekt mit REST-API wiederherstellen

1. Öffnen Sie ein Browserfenster, und geben Sie eine URL ein, die das folgende Formular verwendet:

   'http://ServerName:8080/tfs/DefaultCollection/ProjectName'

   Um beispielsweise eine Verbindung mit dem Server mit dem Namen FabrikamPrime herzustellen, geben Sie Folgendes ein: 'http://FabrikamPrime:8080/tfs/'.

   Der Standardport ist 8080. Geben Sie die Portnummer und das Verzeichnis für Ihren Server an, wenn die Standardeinstellungen nicht verwendet werden.

2. Dient zum Abrufen einer Liste gelöschter Projekte mithilfe der folgenden Anforderung:

   GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3
   

3. Wiederherstellen eines gelöschten Projekts mithilfe der folgenden Anforderung:

   PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
   api-version=5.0-preview.3
   

   Anforderungstext

   {
    "state" : "wellFormed"
   }
   

Wiederherstellen eines Projekts mit PowerShell

1. Führen Sie das folgende PowerShell-Skript aus, um eine Liste der gelöschten Projekte abzurufen und sicherzustellen, dass sie aktualisiert werden $collectionUrl.

   $collectionUrl = "https://localhost/defaultcollection"
   (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
   

   Ähnlich wie der folgende Screenshot wird angezeigt:

2. Verwenden Sie das folgende Skript, um ein Projekt wiederherzustellen. Achten Sie darauf, dass Sie aktualisieren $collectionUrl und $projectName.

   $collectionUrl = "https://localhost/defaultcollection"
   $projectName = 'Project1'
   $project = (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
    | where {$_.name -eq $projectName}
   irm -Uri ($project.url + "?api-version=5.0-preview.3") 
   -UseDefaultCredentials -Method PATCH -Body '{"state":"wellFormed"}'
    -ContentType 'application/json'
   

Ihr Projekt und die zugehörigen Daten werden wiederhergestellt.

Häufig gestellte Fragen

Lesen Sie die folgenden häufig gestellten Fragen zum Löschen von Projekten in Azure DevOps.

F: Warum verfügen Arbeitsaufgaben in einem verbleibenden Projekt nach dem Löschen eines Projekts weiterhin über Verknüpfungen zu den gelöschten Projektarbeitselementen?

A: Arbeitsaufgaben werden innerhalb von 24 Stunden nach dem Löschen des Projekts gelöscht.

F: Ich habe ein Projekt in Azure DevOps gelöscht, aber in Visual Studio Team Explorer ist es immer noch vorhanden, was tue ich?

A: Warten Sie 28 Tage, bis das Projekt endgültig gelöscht wird.

Verwandte Artikel

• Erstellen eines Projekts
• Wiederherstellen eines Projekts
• Löschen eines Projekts mit REST-API
• Verwenden des Befehlszeilentools TFSDeleteProject