Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Se un progetto diventa obsoleto, è possibile delerlo dall'organizzazione o dalla raccolta in Azure DevOps. Se si esegue la migrazione da un Azure DevOps Server locale a servizi Azure DevOps, potrebbe essere necessario eliminare anche il progetto. La rimozione di progetti inutilizzati può migliorare lo spostamento limitandolo solo a quelli attualmente in uso.
Attenzione
- I progetti eliminati temporaneamente dal portale Web vengono rimossi definitivamente se non ripristinati entro 28 giorni.
- In rari casi, il processo di eliminazione potrebbe richiedere fino a 70 giorni a causa di ritentativi del backend e nonché la necessità di eliminare i dati da più origini.
- Non è possibile ripristinare i progetti eliminati definitivamente dalla console di amministrazione locale Azure DevOps.
Per altre informazioni, vedere Ripristinare un progetto e Salvare i dati del progetto.
Prerequisiti
| Categoria |
Requisiti |
| Permissions |
- Membro del gruppo Amministratori della Raccolta del Progetto . I proprietari dell'organizzazione sono automaticamente membri di questo gruppo.
- Eliminare l'autorizzazione del progetto team impostata su Consenti. Per ulteriori informazioni, vedere Visualizza autorizzazioni a livello di progetto. |
| Opzionale |
Salvare i dati del progetto prima di eliminare un progetto se si desidera accedere ai dati del progetto senza ripristinarli. |
| Categoria |
Requisiti |
| Permissions |
Eliminare le autorizzazioni del progetto di team impostate su Consenti. Per altre informazioni, vedere Visualizzare le autorizzazioni. |
| Opzionale |
Salvare i dati del progetto, perché l'eliminazione di un progetto comporta una perdita irreversibile di dati. |
Salvare i dati del progetto
Usare le procedure seguenti per salvare i dati di cui gli utenti si preoccupano di più, come il codice sorgente, i dati di build e gli elementi di lavoro. Questa procedura è facoltativa e può essere utile prima di eliminare un progetto.
Codice sorgente e modelli di compilazione personalizzati: scaricare i file come file ZIP. Seleziona 
per il repository, il file o la cartella e seleziona Scarica come Zip. In alternativa, selezionare 
Scarica per scaricare tutti i file nella cartella attualmente selezionata o il file attualmente selezionato.
Questo processo non salva la cronologia delle modifiche o i collegamenti ad altri artefatti. Se si usa Git, clonare i repository per conservare la cronologia completa del progetto e tutti i rami.
Dati di build: per salvare i log e i dati nelle cartelle di build, vedere Visualizzare i risultati della compilazione.
**Dati di rilevamento degli elementi di lavoro: creare una query dell'elemento di lavoro e aprirla con Excel. Salvare il foglio di calcolo di Excel.
Questo processo non salva allegati, cronologia modifiche o collegamenti ad altri artefatti.
Per ulteriori informazioni, vedere la nostra Panoramica sulla protezione dei dati.
Eliminare un progetto
Usa il browser web per eseguire una cancellazione soft. Dopo 28 giorni, i progetti vengono eliminati definitivamente se non ripristinati entro tale periodo.
Accedi alla tua organizzazione (https://dev.azure.com/{yourorganization}).
Selezionare 
Impostazioni organizzazione.
Selezionare Progetti, selezionare uno o più progetti da eliminare e quindi selezionare Elimina.
Screenshot della sequenza dei progetti selezionati, controlla ogni progetto ed eliminalo.
Confermare l'eliminazione immettendo il nome del progetto e quindi selezionare Elimina nella schermata popup.
Il progetto viene eliminato e può essere ripristinato fino a 28 giorni dopo. Il progetto eliminato viene rimosso dall'elenco dei progetti.
La Console di amministrazione è supportata solo per i server Azure DevOps locali.
Usare la console di amministrazione di Azure DevOps per eseguire un'eliminazione complessa. I progetti vengono eliminati definitivamente e non soggetti al ripristino.
Usando la console di amministrazione, è possibile eliminare un progetto da una raccolta di progetti. Successivamente, è necessario eliminare manualmente tutti i report associati e SharePoint portale del progetto. In alternativa, è possibile usare lo strumento da riga di comando TFSDeleteProject per eliminare tutti gli artefatti.
Se non si è membri di uno o più dei gruppi di amministratori seguenti, ottenere ora le autorizzazioni:
- Gruppo Amministratori Team Foundation (obbligatorio).
- Gruppo Amministratori di Sistema di SQL Server (obbligatorio).
- Gruppo degli Amministratori della Farm per SharePoint Products (obbligatorio quando si utilizza SharePoint Products nella distribuzione).
Aprire la console di amministrazione ed eliminare il progetto dalla raccolta di progetti.
Scegliere se eliminare dati esterni associati al progetto e quindi avviare l'azione di eliminazione.
(Facoltativo) Per esaminare lo stato dell'azione di eliminazione, aprire la scheda Stato.
Per esaminare i dettagli dell'azione di eliminazione, è possibile aprire il file di log dalla scheda Stato o Log.
È possibile eliminare un progetto team con il comando az devops project delete . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.
az devops project delete --id
[--org]
[--yes]
Parametri
- id: obbligatorio. ID del progetto da eliminare. Per determinare l'ID di un progetto, usare il comando az devops project list .
- org: Azure DevOps URL dell'organizzazione. È possibile configurare l'organizzazione predefinita usando
az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.
- Sì: non richiedere conferma.
Esempio
Il comando seguente elimina il progetto team con l'ID specificato senza chiedere conferma.
az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes
I comandi dell'interfaccia a riga di comando di Azure DevOps non sono supportati per Azure DevOps Server.
Eliminare i report che rimangono dopo l'eliminazione di un progetto
Se il progetto ha usato SQL Server report e non sono stati eliminati elementi esterni, è possibile eliminare i report usando SQL Server Gestione report. Dalla pagina della raccolta di progetti eliminare la cartella corrispondente al progetto eliminato.
Ripristinare un progetto eliminato
Se si elimina inavvertitamente un progetto in Azure DevOps, è possibile ripristinarlo entro 28 giorni dall'eliminazione.
Accedi alla tua organizzazione (https://dev.azure.com/{Your_Organization}).
Selezionare Impostazioni organizzazione.
Selezionare Panoramica e quindi scorrere verso il basso fino a "Progetti eliminati di recente".
Evidenziare il progetto da ripristinare e quindi selezionare Ripristina.
Accedi alla tua istanza (http://{ServerName:8080/tfs/}/{CollectionName}).
Scegliere Impostazioni amministrative.
Selezionare Progetti e quindi scorrere verso il basso fino a Progetti eliminati di recente.
Evidenziare il progetto da ripristinare e quindi selezionare Ripristina.
Ripristinare il progetto con l'API REST
Avviso
Per ripristinare un progetto con un nome esistente, rinominare prima il progetto. Per rinominare il progetto, immettere il testo seguente nel corpo della richiesta: "name":"new name".
Aprire una finestra del browser e immettere un URL che usa il formato seguente:
http://ServerName:8080/tfs/DefaultCollection/ProjectName
Ad esempio, per connettersi al server denominato FabrikamPrime, immettere: 'http://FabrikamPrime:8080/tfs/'.
La porta predefinita è 8080. Specificare il numero di porta e la directory per il server se le impostazioni predefinite non vengono usate.
Ottenere un elenco di progetti eliminati usando la richiesta seguente:
GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3
Ripristinare un progetto eliminato usando la richiesta seguente:
PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
api-version=5.0-preview.3
Testo della richiesta
{
"state" : "wellFormed"
}
Ripristinare il progetto con PowerShell
Eseguire lo script di PowerShell seguente per ottenere un elenco di progetti eliminati e assicurarsi di aggiornare $collectionUrl.
$collectionUrl = "https://localhost/defaultcollection"
(irm -Uri "$collectionUrl/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
Usare lo script seguente per ripristinare un progetto. Assicurarsi di aggiornare $collectionUrl e $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'
Il progetto e i dati associati vengono ripristinati.
Domande frequenti
Vedere le domande frequenti seguenti sull'eliminazione di progetti in Azure DevOps.
D: Dopo aver eliminato un progetto, perché gli elementi di lavoro in un progetto rimanente hanno ancora collegamenti agli elementi di lavoro del progetto eliminati?
R: I collegamenti degli elementi di lavoro che puntano agli elementi di lavoro del progetto eliminati rimarranno fino a quando il progetto non viene eliminato definitivamente. Dopo l'eliminazione definitiva del progetto, i collegamenti degli elementi di lavoro vengono eliminati automaticamente entro 24 ore. Se sono necessari i collegamenti dell'elemento di lavoro puliti più velocemente di questo, è possibile rimuoverli manualmente direttamente dal modulo dell'elemento di lavoro.
D: Ho eliminato un progetto in Azure DevOps, ma in Visual Studio Team Explorer è ancora presente, cosa faccio?
R: Attendere 28 giorni prima che il progetto venga eliminato definitivamente.
Usare l'intelligenza artificiale per gestire l'eliminazione e il ripristino del progetto
Se si usano GitHub Copilot, il Azure DevOps MCP Server consente di eliminare, ripristinare e pulire in modo sicuro i progetti Azure DevOps tramite prompt del linguaggio naturale.
Richieste di esempio per l'eliminazione e il ripristino del progetto
| Attività |
Richiesta di esempio |
| Pianificare l'eliminazione di un progetto sicuro |
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 |
| Ripristinare un progetto eliminato accidentalmente |
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 |
| Eseguire la pulizia dopo una migrazione |
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 |
| Controllare i progetti per l'eliminazione dei candidati |
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 |
| Automatizzare l'eliminazione del progetto tramite l'interfaccia della riga di comando |
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 |
| Risolvere i problemi relativi ai collegamenti degli elementi di lavoro interrotti |
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 |
Suggerimento
Per ottenere risultati ottimali, usare questi prompt in modalità agente con il server MCP Azure DevOps connesso. Personalizzare le richieste con il nome del progetto, l'organizzazione o lo scenario di migrazione specifico.
Contenuti correlati
