Eliminare un progetto

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

Se un progetto diventa obsoleto, è possibile eliminarlo dall'organizzazione o dalla raccolta in Azure DevOps. Analogamente, se si esegue la migrazione da un server Azure DevOps locale ad Azure DevOps Services, potrebbe essere necessario eliminare il progetto. La rimozione dei progetti può anche migliorare la navigazione limitandola solo a quei progetti attualmente in uso.

Attenzione

I progetti eliminati dal portale Web vengono eliminati temporaneamente e rimossi definitivamente se non ripristinati entro 28 giorni. Tuttavia, i progetti eliminati dalla console di Amministrazione istration di Azure DevOps locale vengono eliminati definitivamente e non possono essere ripristinati. Per informazioni dettagliate sul ripristino, vedere Ripristinare un progetto. Per accedere ai dati da un progetto eliminato senza ripristinarli, salvare i dati del progetto.

Prerequisiti

• È necessario essere membri del gruppo Project Collection Amministrazione istrators. I proprietari dell'organizzazione sono automaticamente membri di questo gruppo.
• È necessario avere l'autorizzazione Elimina progetto team impostata su Consenti. Per altre informazioni, vedere Visualizzare le autorizzazioni a livello di progetto.
• (Facoltativo) Salvare i dati del progetto prima di eliminare un progetto se si desidera accedere ai dati del progetto senza ripristinarli.

Salvare i dati del progetto

Usare le procedure seguenti per salvare i dati più a cui gli utenti si preoccupano, ad esempio il codice sorgente, compilare i dati 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. Selezionare per il repository, il file o la cartella e selezionare 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.

• Compilare i dati: per salvare i log e i dati nelle cartelle di rilascio della compilazione, vedere Visualizzare i risultati della compilazione.

• Dati di rilevamento degli elementi di lavoro: creare una query dell'elemento di lavoro e aprirla usando Excel. Salvare il foglio di calcolo di Excel.

  Questo processo non salva allegati, cronologia modifiche o collegamenti ad altri artefatti.

Per altre informazioni, vedere Panoramica sulla protezione dei dati.

Eliminare un progetto

Browser

Usare il Web browser per eseguire un'eliminazione temporanea. Dopo 28 giorni, i progetti vengono eliminati definitivamente se non ripristinati entro tale periodo.

1. Accedere all'organizzazione (https://dev.azure.com/{yourorganization}).

2. Seleziona Impostazioni organizzazione.

   

3. Selezionare Progetti, selezionare uno o più progetti da eliminare e quindi selezionare Elimina.

   

4. 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.

Console di Amministrazione istration

La console di Amministrazione istration è supportata solo per i server Azure DevOps locali.

Interfaccia della riga di comando di Azure DevOps

È 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: URL dell'organizzazione di Azure DevOps. È 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

Ripristinare un progetto eliminato

Se si elimina inavvertitamente un progetto in Azure DevOps, è possibile ripristinarlo entro 28 giorni dall'eliminazione.

1. Accedere all'organizzazione (https://dev.azure.com/{yourorganization}).

2. Seleziona Impostazioni organizzazione.

   

3. Selezionare Panoramica e quindi scorrere verso il basso fino a "Progetti eliminati di recente".

   

4. Evidenziare il progetto da ripristinare e quindi selezionare Ripristina.

   

Ripristinare il progetto con l'API REST

Avviso

Per ripristinare un progetto con un nome già acquisito, è necessario rinominare il progetto prima di poterlo ripristinare. Per rinominare il progetto, immettere il testo seguente nel corpo della richiesta: "name":"new name"

1. 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.

2. 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
   

3. Ripristinare un progetto eliminato usando la richiesta seguente:

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

   Corpo della richiesta

   {
    "state" : "wellFormed"
   }
   

Ripristinare il progetto con PowerShell

1. 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
   

   Viene visualizzato un aspetto simile allo screenshot seguente:

2. 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: Gli elementi di lavoro vengono eliminati entro 24 ore dall'eliminazione del progetto.

D: È stato eliminato un progetto in Azure DevOps, ma in Visual Studio Team Explorer è ancora presente, cosa fare?

R: Attendere 28 giorni prima che il progetto venga eliminato definitivamente.

Articoli correlati

• Creare un progetto
• Ripristinare un progetto
• Eliminare un progetto con l'API REST
• Strumento da riga di comando TFSDeleteProject