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:
- Een Microsoft Entra-gebruikersaccount. Als u dat nog niet hebt, kunt u gratis een account maken.
- Een van de volgende rollen:
- Cloudtoepassingsbeheerder
- Toepassingsbeheerder
- eigenaar van de service-principal.
- Een voorlopig verwijderde bedrijfstoepassing in uw tenant.
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.
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
Voer
connect-MgGraph -Scopes "Application.ReadWrite.All"
uit. U moet zich aanmelden als ten minste een cloudtoepassingsbeheerder.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
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
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
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}