Dela via


Ta bort projektet

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Om ett projekt blir föråldrat kan du ta bort det från din organisation eller samling i Azure DevOps. På samma sätt kan det vara nödvändigt att ta bort projektet om du migrerar från en lokal Azure DevOps Server till Azure DevOps Services. Borttagningen av projekt kan också förbättra navigeringen genom att begränsa den till endast de projekt som för närvarande används.

Varning

  • Mjukt borttagna projekt från webbportalen tas bort permanent om de inte återställs inom 28 dagar.
  • I sällsynta fall kan borttagningsprocessen ta upp till 70 dagar på grund av serverdelsförsök och behovet av att ta bort data från flera källor.
  • Det går inte att återställa hårt borttagna projekt från den lokala Azure DevOps-administrationskonsolen. Mer information finns i Återställa ett projekt och Spara projektdata.

Förutsättningar

  • Behörigheter:
    • Vara medlem i gruppen Projektsamlingsadministratörer. Organisationsägare är automatiskt medlemmar i den här gruppen.
    • Ha behörigheten Ta bort teamprojekt inställd på Tillåt. Mer information finns i Visa behörigheter på projektnivå.
  • Valfritt: Spara projektdata innan du tar bort ett projekt om du vill komma åt projektdata utan att återställa dem.
  • Behörigheter: Låt behörigheten Ta bort teamprojekt vara inställd på Tillåt. Mer information finns i Visa behörigheter.
  • Valfritt: Spara projektdata eftersom borttagning av ett projekt resulterar i oåterkallelig dataförlust.

Spara projektdata

Använd följande procedurer för att spara data som användarna bryr sig mest om, till exempel källkod, byggdata och arbetsobjekt. Den här proceduren är valfri och något du kan överväga innan du tar bort ett projekt.

  • Källkod och anpassade byggmallar: Ladda ned dina filer som en zip-fil. Välj Lagringsplatsåtgärder för lagringsplats, fil eller mapp och välj Ladda ned som Zip. Du kan också välja Ladda ned för att ladda ned alla filer i den markerade mappen eller den valda filen.

    Skärmbild av nedladdning av kod.

    Den här processen sparar inte någon ändringshistorik eller länkar till andra artefakter. Om du använder Git klonar du dina lagringsplatser för att behålla hela projekthistoriken och alla grenar.

  • Skapa data: Information om hur du sparar loggar och data i dina drop build-mappar finns i Visa byggresultat.

  • Spårningsdata för arbetsobjekt: Skapa en arbetsobjektfråga och öppna den med Excel. Spara Excel-kalkylbladet.

    Den här processen sparar inga bifogade filer, ändringshistorik eller länkar till andra artefakter.

Mer information finns i översikten över dataskyddet.

Ta bort projekt

Använd webbläsaren för att utföra en mjuk borttagning. Efter 28 dagar tas projekt bort permanent om de inte återställs inom den tiden.

  1. Logga in på din organisation (https://dev.azure.com/{yourorganization}).

  2. Välj kugghjulsikon Organisationsinställningar.

    Skärmbild av val, Organisationsinställningar.

  3. Välj Projekt, markera ett eller flera projekt att ta bort och välj sedan Ta bort.

    Skärmbild av sekvensen som valts Projekt, kontrollera varje projekt och ta bort.

  4. Bekräfta borttagningen genom att ange projektnamnet och välj sedan Ta bort på popup-skärmen.

    Skärmbild av projektskärmen för borttagning av popup-bekräftelse.

Projektet tas bort och kan återställas upp till 28 dagar efteråt. Det borttagna projektet tas bort från projektlistan.

Ta bort rapporter som finns kvar när du har tagit bort ett projekt

Om ditt projekt använde SQL Server-rapportering och du inte tog bort externa artefakter kan du ta bort rapporterna med hjälp av SQL Server Report Manager. Ta bort mappen som motsvarar det borttagna projektet från projektsamlingssidan.

Skärmbild av snabbmenyn med kommandot ta bort.

Återställa ett borttaget projekt

Om du oavsiktligt tar bort ett projekt i Azure DevOps kan du återställa det inom 28 dagar efter borttagningen.

  1. Logga in på din organisation (https://dev.azure.com/{yourorganization}).

  2. Välj kugghjulsikon Organisationsinställningar.

    Skärmbild som visar kugghjulsikonen Organisationsinställningar.

  3. Välj Översikt och rulla sedan ned till "nyligen borttagna projekt".

    Skärmbild som visar nyligen borttagna projekt.

  4. Markera det projekt som du vill återställa och välj sedan Återställ.

    Skärmbild som visar markerat projekt och knappen Återställ.

  1. Logga in på din instans (http://{ServerName:8080/tfs/}/{CollectionName}).

  2. Välj kugghjulsikon Administratörsinställningar.

    Skärmbild som visar knappen Administratörsinställningar omgiven av röd ruta.

  3. Välj Projekt och rulla sedan ned till Nyligen borttagna projekt.

  4. Markera det projekt som du vill återställa och välj sedan Återställ.

    Skärmbild som visar hur du markerar projektet och sedan väljer Återställ för Azure DevOps Server.

Kommentar

Användargränssnittet stöder inte återställning av ett teamprojekt för Azure DevOps Server 2019. Använd följande REST API- eller PowerShell-metoder för att återställa ett borttaget teamprojekt. Mer information finns i Projects-Update REST API.

Återställa projektet med REST API

Varning

Om du vill återställa ett projekt med ett namn som redan har tagits måste du byta namn på projektet innan du kan återställa det. Om du vill byta namn på projektet anger du följande text i begärandetexten: "name":"new name"

  1. Öppna ett webbläsarfönster och ange en URL som använder följande formulär:

    'http://ServerName:8080/tfs/DefaultCollection/ProjectName'

    Om du till exempel vill ansluta till servern med namnet FabrikamPrime anger du: 'http://FabrikamPrime:8080/tfs/'.

    Standardporten är 8080. Ange portnummer och katalog för servern om standardvärdena inte används.

  2. Hämta en lista över borttagna projekt med hjälp av följande begäran:

    GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
    deleted&api-version=5.0-preview.3
    
  3. Återställ ett borttaget projekt med hjälp av följande begäran:

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

    Begärandetext

    {
     "state" : "wellFormed"
    }
    

Återställa projektet med PowerShell

  1. Kör följande PowerShell-skript för att hämta en lista över borttagna projekt och se till att uppdatera $collectionUrl.

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

    Något som liknar följande skärmbild visas: Skärmbild av PowerShell-skriptreturexempel för borttagna projekt.

  2. Använd följande skript för att återställa ett projekt. Se till att uppdatera $collectionUrl och $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'
    

Projektet och tillhörande data återställs.

Vanliga frågor och svar

Se följande vanliga frågor om att ta bort projekt i Azure DevOps.

S: Arbetsobjekt tas bort inom 24 timmar efter att projektet har tagits bort.

F: Jag har tagit bort ett projekt i Azure DevOps, men i Visual Studio Team Explorer finns det fortfarande kvar, vad gör jag?

S: Vänta 28 dagar innan projektet tas bort permanent.