Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Wenn ein Projekt veraltet ist, können Sie es löschen aus Ihrer Organisation oder Sammlung in Azure DevOps. Wenn Sie von einer 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 |
| Erlaubnisse |
Berechtigungssatz für Teamprojekt auf "Zulassen" löschen. Weitere Informationen finden Sie unter Berechtigungen anzeigen. |
| Fakultativ |
Projektdatenspeichern, da das Löschen eines Projekts zu unwiderruflichen Datenverlusten führt. |
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 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.
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.
Builddaten: Informationen zum Speichern von Protokollen und Daten in Den Drop-Buildordnern finden Sie unter Anzeigen von Buildergebnissen.
**Nachverfolgungsdaten für Arbeitsaufgaben: Erstellen Sie eine Arbeitsaufgabenabfrage, 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
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.
Melden Sie sich bei Ihrem organization (https://dev.azure.com/{yourorganization}) an.
Wählen Sie die Organisationseinstellungen über das 
aus.
Wählen Sie "Projekte" aus, überprüfen Sie ein oder mehrere zu löschende Projekte, und wählen Sie dann "Löschen" aus.
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 später wiederhergestellt werden. Ihr gelöschtes Projekt wird aus Ihrer Projektliste entfernt.
Die Verwaltungskonsole wird nur für lokale Azure DevOps Server unterstützt.
Verwenden Sie die Azure DevOps Verwaltungskonsole, um einen endgültigen Löschvorgang auszuführen. Projekte werden dauerhaft gelöscht und können nicht wiederhergestellt werden.
Über die Verwaltungskonsole können Sie ein Projekt aus einer Projektsammlung löschen. Anschließend müssen Sie alle zugehörigen Berichte und SharePoint Projektportal manuell löschen. Sie können auch das Befehlszeilen-Tool TFSDeleteProject verwenden, um alle Artefakte zu löschen.
Wenn Sie nicht Mitglied einer oder mehrerer der folgenden Administratorengruppen sind, sollten Sie sich jetzt die Berechtigungen besorgen:
- Team Foundation Administrators-Gruppe (erforderlich).
- SQL Server Gruppe "Systemadministratoren" (erforderlich).
- Gruppe "Farmadministratoren" für SharePoint-Produkte (erforderlich, wenn Ihre Bereitstellung SharePoint Produkte verwendet).
Öffnen Sie die Verwaltungskonsole und löschen Sie das Projekt aus seiner Projektsammlung.
Wählen Sie aus, ob externe Daten, die mit dem Projekt verbunden sind, gelöscht werden sollen, und starten Sie dann die Löschaktion.
(Optional) Um den Status der Löschaktion zu überprüfen, öffnen Sie die Registerkarte "Status".
Um die Details der Löschaktion zu überprüfen, können Sie die Protokolldatei entweder über die Registerkarte "Status" oder "Protokolle" öffnen.
Sie können ein Teamprojekt mit dem Befehl az devops project delete löschen. Informationen zu den ersten Schritten finden Sie unter Get started with 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 Organisation-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 werden nicht zur Bestätigung aufgefordert.
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
Azure DevOps CLI-Befehle werden für Azure DevOps Server nicht unterstützt.
Löschen von Berichten, die nach dem Löschen eines Projekts verbleiben
Wenn Ihr Projekt SQL Server Berichterstellung verwendet hat und Sie keine externen Artefakte gelöscht haben, können Sie die Berichte mit SQL Server Berichts-Manager löschen. Löschen Sie auf der Seite der Projektsammlung den Ordner, der dem gelöschten Projekt entspricht.
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.
Melden Sie sich bei Ihrem organization (https://dev.azure.com/{Your_Organization}) an.
Wählen Sie "Organisationseinstellungen" aus.
Wählen Sie "Übersicht" aus, und scrollen Sie dann nach unten zu "Zuletzt gelöschte Projekte".
Markieren Sie das Projekt, das Sie wiederherstellen möchten, und wählen Sie dann "Wiederherstellen" aus.
Melden Sie sich bei der ACR-Instanz an (http://{ServerName:8080/tfs/}/{CollectionName}).
Wählen Sie " aus.
Wählen Sie "Projekte" aus, und scrollen Sie dann nach unten zu zuletzt gelöschten Projekten.
Markieren Sie das Projekt, das Sie wiederherstellen möchten, und wählen Sie dann "Wiederherstellen" aus.
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".
Ö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 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 nicht die Standardeinstellungen verwendet werden.
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
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
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
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 immer noch vorhanden, was tue ich?
A: Warten Sie 28 Tage, bevor das Projekt endgültig gelöscht wird.
Verwenden von KI zum Verwalten von Projektlöschung und Wiederherstellung
Wenn Sie GitHub Copilot verwenden, kann Ihnen der Azure DevOps MCP Server dabei helfen, Azure DevOps-Projekte sicher zu löschen, wiederherzustellen und aufzuräumen.
Beispielaufforderungen für das Löschen und Wiederherstellen von Projekten
| Aufgabe |
Beispielaufforderung |
| Planen eines sicheren Projektlöschvorgangs |
I need to delete an obsolete project but want to preserve its build definitions and work item history first. Walk me through exporting the critical data before I delete the project |
| Wiederherstellen eines versehentlich gelöschten Projekts |
A team member accidentally deleted our staging project yesterday. Show me how to restore it before the 28-day permanent deletion window expires and verify all repos and pipelines are intact |
| Bereinigen nach einer Migration |
We migrated from Azure DevOps Server to Azure DevOps Services and have leftover projects in the old collection. Guide me through identifying which ones are safe to hard-delete from the admin console |
| Überwachen von Projekten für Löschkandidaten |
List all projects in my organization that have had zero commits, no pipeline runs, and no work item updates in the last 6 months so I can evaluate them for deletion |
| Automatisieren der Projektlöschung über CLI |
I need to delete 5 test projects we created during a proof of concept. Show me how to use the Azure DevOps CLI to delete them in batch and verify each deletion completed |
| Fehlerbehebung bei defekten Arbeitsaufgabenelementenlinks |
After deleting a project, work items in our other projects still show links to the deleted project. Explain when these links get cleaned up and how to remove them manually if needed |
Tipp
Um optimale Ergebnisse zu erzielen, verwenden Sie diese Eingabeaufforderungen im Agentmodus, wobei der Azure DevOps MCP-Server verbunden ist. Passen Sie die Eingabeaufforderungen mit Ihrem spezifischen Projektnamen, Ihrer Organisation oder Ihrem Migrationsszenario an.
Verwandte Inhalte
