Een project verwijderen

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

Als een project verouderd wordt, kunt u het verwijderen uit uw organisatie of verzameling in Azure DevOps. Als u migreert van een on-premises Azure DevOps-server naar Azure DevOps Services, kan het nodig zijn om het project te verwijderen. Het verwijderen van projecten kan ook de navigatie verbeteren door deze te beperken tot alleen de projecten die momenteel in gebruik zijn.

Let op

• Voorlopig verwijderde projecten uit de webportal worden definitief verwijderd als ze niet binnen 28 dagen worden hersteld.
• In zeldzame gevallen kan het verwijderen tot 70 dagen duren vanwege nieuwe pogingen van de back-end en de noodzaak om gegevens uit meerdere bronnen te verwijderen.
• Hard-verwijderde projecten uit de on-premises Azure DevOps-beheerconsole kunnen niet worden hersteld. Zie Een project herstellen en projectgegevens opslaan voor meer informatie.

Vereisten

• Machtigingen:
  • Lid zijn van de groep Beheerders van projectverzamelingen. Eigenaren van organisaties zijn automatisch lid van deze groep.
  • Stel de machtiging Teamproject verwijderen in op Toestaan. Zie Machtigingen op projectniveau weergeven voor meer informatie.
• Optioneel: Sla projectgegevens op voordat u een project verwijdert als u toegang wilt krijgen tot projectgegevens zonder deze te herstellen.

Projectgegevens opslaan

Gebruik de volgende procedures om gegevens op te slaan die gebruikers het belangrijkst hebben, zoals broncode, gegevens bouwen en werkitems. Deze procedure is optioneel en u kunt overwegen voordat u een project verwijdert.

• Broncode en aangepaste buildsjablonen: Download uw bestanden als een zip-bestand. Selecteer voor de opslagplaats, het bestand of de map en selecteer Downloaden als Zip. Of selecteer Downloaden om alle bestanden in de geselecteerde map of het geselecteerde bestand te downloaden.

  

  Met dit proces worden geen wijzigingsgeschiedenis of koppelingen naar andere artefacten opgeslagen. Als u Git gebruikt, kloont u uw opslagplaatsen om de volledige projectgeschiedenis en alle vertakkingen te behouden.

• Buildgegevens: Zie buildresultaten weergeven om logboeken en gegevens op te slaan in uw drop build-mappen.

• Traceringsgegevens voor werkitems: maak een werkitemquery en open deze met Excel. Sla het Excel-spreadsheet op.

  Met dit proces worden geen bijlagen, wijzigingsgeschiedenis of koppelingen naar andere artefacten opgeslagen.

Zie ons overzicht van gegevensbescherming voor meer informatie.

Project verwijderen

Browser

Gebruik uw webbrowser om een voorlopig verwijderen uit te voeren. Na 28 dagen worden projecten definitief verwijderd als ze niet binnen die tijd worden hersteld.

1. Meld u aan bij uw organisatie (https://dev.azure.com/{yourorganization}).

2. Selecteer Organisatie-instellingen.

   

3. Selecteer Projecten, controleer een of meer projecten die u wilt verwijderen en selecteer vervolgens Verwijderen.

   

4. Bevestig het verwijderen door de projectnaam in te voeren en selecteer Vervolgens Verwijderen in het pop-upscherm.

   

Uw project wordt verwijderd en kan tot 28 dagen daarna worden hersteld. Uw verwijderde project wordt verwijderd uit de lijst met projecten.

Beheerconsole

De beheerconsole wordt alleen ondersteund voor on-premises Azure DevOps-servers.

Azure DevOps CLI

U kunt een teamproject verwijderen met de opdracht az devops project delete . Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

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

Parameters

• id: vereist. De id van het project dat u wilt verwijderen. Gebruik de opdracht az devops project list om de id van een project te bepalen.
• organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=ORG_URL. Vereist als deze niet is geconfigureerd als standaard of wordt opgehaald met behulp van git config. Voorbeeld: --org https://dev.azure.com/MyOrganizationName/.
• Ja: Niet vragen om bevestiging.

Opmerking

Met de volgende opdracht wordt het teamproject met de opgegeven id verwijderd zonder dat u om bevestiging wordt gevraagd.

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

Een verwijderd project herstellen

Als u per ongeluk een project verwijdert in Azure DevOps, kunt u het binnen 28 dagen na de verwijdering herstellen.

1. Meld u aan bij uw organisatie (https://dev.azure.com/{yourorganization}).

2. Selecteer Organisatie-instellingen.

   

3. Selecteer Overzicht en schuif omlaag naar 'onlangs verwijderde projecten'.

   

4. Markeer het project dat u wilt herstellen en selecteer vervolgens Herstellen.

   

Project herstellen met REST API

Waarschuwing

Als u een project wilt herstellen met een naam die al is gemaakt, moet u de naam van het project wijzigen voordat u het kunt herstellen. Als u de naam van het project wilt wijzigen, voert u de volgende tekst in de hoofdtekst van de aanvraag in: "name":"new name"

1. Open een browservenster en voer een URL in die gebruikmaakt van het volgende formulier:

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

   Als u bijvoorbeeld verbinding wilt maken met de server met de naam FabrikamPrime, voert u het volgende in: 'http://FabrikamPrime:8080/tfs/'.

   De standaardpoort is 8080. Geef het poortnummer en de map voor uw server op als de standaardinstellingen niet worden gebruikt.

2. Haal een lijst met verwijderde projecten op met behulp van de volgende aanvraag:

   GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3
   

3. Herstel een verwijderd project met behulp van de volgende aanvraag:

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

   Aanvraagtekst

   {
    "state" : "wellFormed"
   }
   

Project herstellen met PowerShell

1. Voer het volgende PowerShell-script uit om een lijst met verwijderde projecten op te halen en zorg ervoor dat u deze bijwerkt $collectionUrl.

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

   Er wordt iets soortgelijks weergegeven als in de volgende schermopname:

2. Gebruik het volgende script om een project te herstellen. Zorg ervoor dat u bijwerkt $collectionUrl en $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'
   

Uw project en de bijbehorende gegevens worden hersteld.

Veelgestelde vragen

Zie de volgende veelgestelde vragen over het verwijderen van projecten in Azure DevOps.

V: Nadat u één project hebt verwijderd, waarom bevatten werkitems in een resterend project nog steeds koppelingen naar de verwijderde projectwerkitems?

A: Werkitems worden binnen 24 uur na het verwijderen van uw project verwijderd.

V: Ik heb een project verwijderd in Azure DevOps, maar in Visual Studio Team Explorer is het nog steeds aanwezig, wat moet ik doen?

A: Wacht 28 dagen voordat het project definitief wordt verwijderd.

Verwante artikelen:

• Een project maken
• Een project herstellen
• Een project verwijderen met REST API
• Het opdrachtregelprogramma TFSDeleteProject gebruiken