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.

Achtung

Aus dem Webportal gelöschte Projekte werden vorläufig gelöscht und dauerhaft entfernt, wenn sie nicht innerhalb von 28 Tagen wiederhergestellt werden. Projekte, die aus der lokalen Azure DevOps-Verwaltungskonsole gelöscht wurden, werden jedoch endgültig gelöscht und können nicht wiederhergestellt werden. Details zur Wiederherstellung finden Sie unter "Wiederherstellen eines Projekts". Um auf Daten aus einem gelöschten Projekt zuzugreifen, ohne es wiederherzustellen, speichern Sie Projektdaten.

Voraussetzungen

• Sie müssen Mitglied der Gruppe Projektsammlungsadministratoren sein. Organisationsbesitzer sind automatisch Mitglieder dieser Gruppe.
• Sie müssen die Berechtigung "Teamprojekt löschen " auf " Zulassen" festgelegt haben. Weitere Informationen finden Sie unter "Berechtigungen auf Projektebene anzeigen".
• (Optional) Speichern Sie Projektdaten , bevor Sie ein Projekt löschen, wenn Sie auf Projektdaten zugreifen möchten, ohne sie wiederherzustellen.

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.

Löschen eines Projekts

Browser

Verwenden Sie Ihren Webbrowser, um ein vorläufiges Löschen durchzuführen. Nach 28 Tagen werden Projekte dauerhaft gelöscht, wenn sie nicht innerhalb dieses Zeitraums wiederhergestellt werden.

1. Melden Sie sich bei Ihrem organization (https://dev.azure.com/{yourorganization}) an.

2. Wählen Sie Organisationseinstellungen aus.

   

3. Wählen Sie "Projekte" aus, überprüfen Sie ein oder mehrere zu löschende Projekte, und wählen Sie dann "Löschen" aus.

   

4. Bestätigen Sie das Löschen, indem Sie den Projektnamen eingeben, und wählen Sie dann im Popupbildschirm "Löschen" aus.

   

Ihr Projekt wird gelöscht und kann bis zu 28 Tage danach wiederhergestellt werden. Ihr gelöschtes Projekt wird aus der Projektliste entfernt.

Verwaltungskonsole

Die Verwaltungskonsole wird nur für lokale Azure DevOps-Server unterstützt.

Erste Schritte mit der Azure DevOps-CLI

Sie können ein Teamprojekt mit dem Befehl zum Löschen des Az devops-Projekts löschen . Informationen zu den ersten Schritten finden Sie unter Erste Schritte mit Azure DevOps CLI.

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

Parameter

• id: Erforderlich. Die ID des Projekts, das Sie löschen möchten. Verwenden Sie den Befehl "az devops-Projektliste ", um die ID eines Projekts zu ermitteln.
• org: URL der Azure DevOps-Organisation. Sie können die Standard-organization mit az devops configure -d organization=ORG_URLkonfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.
• ja: Sie müssen nicht zur Bestätigung aufgefordert werden.

Beispiel

Mit dem folgenden Befehl wird das Teamprojekt mit der angegebenen ID gelöscht, ohne Sie zur Bestätigung aufzufordern.

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.

1. Melden Sie sich bei Ihrem organization (https://dev.azure.com/{yourorganization}) an.

2. Wählen Sie Organisationseinstellungen aus.

   

3. Wählen Sie "Übersicht" aus, und scrollen Sie dann nach unten zu "Zuletzt gelöschte Projekte".

   

4. Markieren Sie das Projekt, das Sie wiederherstellen möchten, und wählen Sie dann "Wiederherstellen" aus.

   

Projekt mit REST-API wiederherstellen

Warnung

Zum Wiederherstellen eines Projekts mit einem bereits übernommenen Namen müssen Sie das Projekt umbenennen, bevor Sie es wiederherstellen können. Um das Projekt umzubenennen, geben Sie den folgenden Text im Anforderungstext ein: "name":"new name"

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: Nachdem Sie ein Projekt gelöscht haben, warum haben Arbeitsaufgaben in einem Neuprojekt Standard weiterhin 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
• TFSDeleteProject-Befehlszeilentool