Löschen eines Projekts

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Wenn ein Projekt veraltet ist, können Sie es aus Ihrem Unternehmen oder Ihrer Sammlung in Azure DevOps löschen. Wenn Sie von einem lokalen Azure DevOps Server zu Azure DevOps Services migrieren, müssen Sie das Projekt möglicherweise auch löschen. Durch das Entfernen nicht verwendeter Projekte kann die Navigation verbessert werden, indem sie nur auf die Projekte beschränkt wird, die derzeit verwendet werden.

Achtung

• Vorläufig gelöschte Projekte aus dem Webportal werden dauerhaft entfernt, wenn sie nicht innerhalb von 28 Tagen wiederhergestellt werden.
• In seltenen Fällen kann unser Löschvorgang bis zu 70 Tage dauern, da Back-End-Wiederholungen erforderlich sind und die Daten aus mehreren Quellen gelöscht werden müssen.
• Hart gelöschte Projekte aus der lokalen Azure DevOps-Verwaltungskonsole können nicht wiederhergestellt werden. Weitere Informationen finden Sie unter Ein Projekt wiederherstellen und Projektdaten speichern.

Voraussetzungen

Kategorie	Anforderungen
Berechtigungen	- Mitglied der Gruppe Projektsammlungsadministratoren. Organisationsbesitzer sind automatisch Mitglieder dieser Gruppe. - Die Berechtigung Teamprojekt löschen ist auf Zulassen festgelegt. Weitere Informationen finden Sie unter Anzeigen von Berechtigungen auf Projektebene.
Optional	Speichern von Projektdaten vor dem Löschen eines Projekts, wenn Sie auf Projektdaten zugreifen möchten, ohne sie wiederherzustellen.

Speichern von Projektdaten

Verwenden Sie die folgenden Verfahren, um die Daten zu speichern, die für die Benutzer am wichtigsten sind, wie Quellcode, Build-Daten und Workitems. Dieses Verfahren ist optional und sollte vor dem Löschen eines Projekts in Betracht gezogen werden.

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

  

  Bei diesem Prozess werden keine Verlaufsdaten oder Verknüpfungen zu anderen Artefakten gespeichert. Wenn Sie Git verwenden, klonen Sie Ihre Repositorys, um die vollständigen Verlaufsdaten des Projekts und alle Zweige zu erhalten.

• Build-Daten: Wie Sie Protokolle und Daten in Ihren Drop-Build-Ordnern speichern, erfahren Sie unter Build-Ergebnisse anzeigen.

• Daten zur Verfolgung des Workitems: Erstellen Sie eine Workitem-Abfrage und öffnen Sie sie mit Excel. Speichern Sie die Excel-Tabelle.

  Bei diesem Vorgang werden keine Anhänge, Verlaufsdaten oder Links zu anderen Artefakten gespeichert.

Weitere Informationen finden Sie in unserer Übersicht zum Datenschutz.

Löschen eines Projekts

Browser

Verwenden Sie Ihren Webbrowser, um ein vorläufiges Löschen durchzuführen. Nach 28 Tagen werden die Projekte endgültig 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, markieren Sie ein oder mehrere Projekte, die Sie löschen möchten, und wählen Sie dann Löschen.

   

4. Bestätigen Sie den Löschvorgang durch Eingabe des Projektnamens und wählen Sie dann im Popup-Fenster Löschen.

   

Ihr Projekt wird gelöscht und kann bis zu 28 Tage später wiederhergestellt werden. Ihr gelöschtes Projekt wird aus Ihrer Projektliste entfernt.

Verwaltungskonsole

Die Verwaltungskonsole unterstützt nur lokale Azure DevOps Server.

Erste Schritte mit der Azure DevOps-CLI

Sie können ein Teamprojekt mit dem Befehl az devops project delete löschen. Informationen zu den ersten Schritten finden Sie unter Erste Schritte mit der Azure DevOps-CLI.

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

Parameter

• id: Erforderlich. Die ID des Projekts, das Sie löschen möchten. Um die ID eines Projekts zu ermitteln, verwenden Sie den Befehl az devops project list.
• org: Azure DevOps-Organisations-URL. 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

Der folgende Befehl löscht das Teamprojekt mit der angegebenen ID, 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 in Azure DevOps versehentlich löschen, können Sie es innerhalb von 28 Tagen nach der Löschung wiederherstellen.

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

2. Wählen Sie Organisationseinstellungen aus.

   

3. Wählen Sie Übersicht und blättern Sie dann nach unten zu „kürzlich gelöschte Projekte“.

   

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

   

Projekt mit REST API wiederherstellen

Warnung

Um ein Projekt mit einem vorhandenen Namen wiederherzustellen, benennen Sie das Projekt zuerst um. 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 Format hat:

   „http://ServerName:8080/tfs/DefaultCollection/ProjectName“

   Um beispielsweise eine Verbindung zum 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 nicht die Standardeinstellungen verwendet werden.

2. Rufen Sie eine Liste der gelöschten Projekte mit der folgenden Anforderung ab:

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

3. Stellen Sie ein gelöschtes Projekt mit der folgenden Anforderung wieder her:

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

   Anforderungstext

   {
    "state" : "wellFormed"
   }
   

Projekt mit PowerShell wiederherstellen

1. Führen Sie das folgende PowerShell-Skript aus, um eine Liste der gelöschten Projekte zu erhalten, und aktualisieren Sie $collectionUrl.

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

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

   $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 haben Workitems in einem verbleibenden Projekt nach dem Löschen eines Projekts weiterhin Verknüpfungen zu den Workitems des gelöschten Projekts?

A: Arbeitselementlinks, die auf gelöschte Projektarbeitselemente verweisen, bleiben erhalten, bis das Projekt endgültig gelöscht wird. Sobald das Projekt endgültig gelöscht wurde, werden die Arbeitsaufgabenlinks innerhalb von 24 Stunden automatisch bereinigt. Wenn die Work Item-Links schneller bereinigt werden müssen, können Sie sie direkt aus dem Arbeitselementformular manuell entfernen.

F: Ich habe ein Projekt in Azure DevOps gelöscht, aber in Visual Studio Team Explorer ist es noch vorhanden. Was soll ich tun?

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

Verwandte Inhalte

• Ein Projekt erstellen
• Wiederherstellen eines Projekts
• Ein Projekt mit der REST-API löschen
• Verwenden Sie das Befehlszeilen-Tool TFSDeleteProject