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

Projekt som tas bort från webbportalen tas bort och tas bort permanent om de inte återställs inom 28 dagar. Projekt som tas bort från den lokala Azure DevOps-administrationskonsolen tas dock bort hårt och kan inte återställas. Mer information om återställning finns i Återställa ett projekt. Om du vill komma åt data från ett borttaget projekt utan att återställa dem sparar du projektdata.

Förutsättningar

• Du måste vara medlem i gruppen Projektsamlingsadministratörer. Organisationsägare är automatiskt medlemmar i den här gruppen.
• Du måste 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.

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

  

  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

Webbläsare

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 Organisationsinställningar.

   

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

   

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

   

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

Administrationskonsolen

Administrationskonsolen stöds endast för lokala Azure DevOps-servrar.

Azure DevOps CLI

Du kan ta bort ett teamprojekt med kommandot az devops project delete . Kom igång genom att läsa Komma igång med Azure DevOps CLI.

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

Parametrar

• id: Krävs. ID:t för projektet som du vill ta bort. Om du vill fastställa ID:t för ett projekt använder du kommandot az devops project list .
• org: Url för Azure DevOps-organisationen. Du kan konfigurera standardorganisationen med .az devops configure -d organization=ORG_URL Krävs om det inte är konfigurerat som standard eller hämtas med hjälp av git config. Exempel: --org https://dev.azure.com/MyOrganizationName/.
• Ja: Fråga inte efter bekräftelse.

Exempel

Följande kommando tar bort teamprojektet med det angivna ID:t utan att du uppmanas att bekräfta det.

az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes

Å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 Organisationsinställningar.

   

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

   

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

   

Å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:

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 om

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

F: Varför finns det fortfarande länkar till de borttagna projektarbetsobjekten när du har tagit bort ett projekt?

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.

Relaterade artiklar

• Skapa ett projekt
• Återställa ett projekt
• Ta bort ett projekt med REST API
• Kommandoradsverktyget TFSDeleteProject