Delen via


Een tijdelijk verwijderde ondernemingstoepassing herstellen

In dit artikel leert u hoe u een zacht verwijderde enterprise-applicatie herstelt in uw Microsoft Entra-tenant. Voorlopig verwijderde bedrijfstoepassingen kunnen binnen 30 dagen na verwijdering vanuit de Prullenbak worden hersteld. Na het tijdvenster van 30 dagen wordt de bedrijfstoepassing definitief verwijderd en kan deze niet meer worden hersteld.

Als u een toepassingsregistratie in de thuistenant hebt verwijderd via de sectie app-registraties in het Microsoft Entra-beheercentrum, is de bedrijfstoepassing, welke de bijbehorende service-principal is, verwijderd.

Als u de verwijderde applicatieregistratie herstelt via het Microsoft Entra-admin-centrum, wordt de bijbehorende service-principal ook hersteld. Daarom kunt u de vorige configuraties van de service-principal herstellen, met uitzondering van de vorige beleidsregels, zoals de beleidsregels voor voorwaardelijke toegang, die niet worden hersteld.

Vereisten

Voor het herstellen van een bedrijfstoepassing hebt u het volgende nodig:

Voer de volgende stappen uit om een onlangs verwijderde bedrijfstoepassing te herstellen. Zie Veelgestelde vragen over het verwijderen en herstellen van toepassingen voor meer informatie over het verwijderen en herstellen van toepassingen.

Herstelbare bedrijfstoepassingen weergeven met behulp van Microsoft Entra PowerShell

Zorg ervoor dat u de module Microsoft Entra PowerShell gebruikt.

U moet zich aanmelden als ten minste een cloudtoepassingsbeheerder.

  1. Voer de volgende opdracht uit om de onlangs verwijderde bedrijfstoepassing weer te geven.

    Connect-Entra -Scopes 'Application.Read.All'
    Get-EntraDeletedServicePrincipal
    

Vervang de ID door de object-ID van de service-principal die u wilt herstellen.

Herstelbare bedrijfstoepassingen weergeven met behulp van Microsoft Graph PowerShell

  1. Voer connect-MgGraph -Scopes "Application.ReadWrite.All" uit. U moet zich aanmelden als ten minste een cloudtoepassingsbeheerder.

  2. Voer de volgende opdracht uit om de onlangs verwijderde bedrijfstoepassingen weer te geven.

    Get-MgDirectoryDeletedItem -DirectoryObjectId <id>
    

Vervang de ID door de object-ID van de service-principal die u wilt herstellen.

Herstelbare bedrijfstoepassingen weergeven met behulp van Microsoft Graph API

Onlangs verwijderde bedrijfstoepassingen weergeven en herstellen met Graph Explorer. U moet zich aanmelden als ten minste een cloudtoepassingsbeheerder.

Voer de volgende query uit om de lijst met verwijderde bedrijfstoepassingen in uw tenant op te halen.

GET https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.servicePrincipal

Noteer in de lijst met verwijderde service-principals die zijn gegenereerd de id van de bedrijfstoepassing die u wilt herstellen.

Als u de specifieke bedrijfstoepassing wilt ophalen die is verwijderd, haalt u de verwijderde service-principal op en filtert u de resultaten op de toepassings-id (appId) van de client met behulp van de volgende syntaxis:

https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.servicePrincipal?$filter=appId eq '{appId}'. Nadat u de object-id van de verwijderde service-principal hebt opgehaald, gaat u verder met het herstellen.

Een bedrijfs-app herstellen met Behulp van Microsoft Entra PowerShell

  1. Voer de volgende opdracht uit om de voorlopig verwijderde bedrijfstoepassing te herstellen:

    Connect-Entra -Scopes 'Application.ReadWrite.All'
    #get the deleted service principal by filtering by the display name.
    $deletedServicePrincipal = Get-EntraDeletedServicePrincipal -Filter "DisplayName eq 'test-App1-Deleted'"
    
    #assign the value returned to a variable and restore the deleted service principal
    Id = $deletedServicePrincipal.Id
    Restore-EntraDeletedDirectoryObject -Id $deletedServicePrincipal.Id
    

Een bedrijfs-app herstellen met Microsoft Graph PowerShell

  1. Voer de volgende opdracht uit om de bedrijfstoepassing te herstellen:

    Restore-MgDirectoryDeletedItem -DirectoryObjectId <id>
    

Vervang de ID door de object-ID van de service-principal die u wilt herstellen.

Een bedrijfs-app herstellen met behulp van Microsoft Graph API

Voer de volgende query uit om de bedrijfstoepassing te herstellen:

POST https://graph.microsoft.com/v1.0/directory/deletedItems/{id}/restore

Vervang de ID door de object-ID van de service-principal die u wilt herstellen.

Service-principals voor soft-verwijderde beheerde identiteiten kunnen worden bekeken, maar kunnen niet door klanten worden hersteld of permanent verwijderd.

Waarschuwing

Het permanent verwijderen van een bedrijfstoepassing is een onherstelbare actie. Eventuele aanwezige configuraties in de app gaan verloren. Bekijk zorgvuldig de details van de bedrijfstoepassing om er zeker van te zijn dat u deze echt permanent wilt verwijderen.

Een bedrijfs-app definitief verwijderen met Behulp van Microsoft Entra PowerShell

Om een zacht verwijderde bedrijfsapplicatie permanent te verwijderen, voert u de volgende opdracht uit:

   Connect-Entra -Scopes 'Application.ReadWrite.All'
   #get the deleted service principal by filtering by the display name.
   $deletedServicePrincipal = Get-EntraDeletedServicePrincipal -Filter "DisplayName eq 'test-App1-Deleted'"

   #assign the value returned to a variable and permanently delete the service principal
   $Id = $deletedServicePrincipal.Id
   Remove-EntraDeletedDirectoryObject -Id $deletedServicePrincipal.Id

Een bedrijfs-app definitief verwijderen met Behulp van Microsoft Graph PowerShell

  1. Om de soft-verwijderde bedrijfstoepassing permanent te verwijderen, voert u de volgende opdracht uit:

    Remove-MgDirectoryDeletedItem -DirectoryObjectId <id>
    

Een bedrijfs-app definitief verwijderen met behulp van Microsoft Graph API

Als u een voorlopig verwijderde bedrijfstoepassing definitief wilt verwijderen, voert u de volgende query uit in Microsoft Graph Explorer.

DELETE https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}