在 Microsoft Entra ID 中还原企业应用程序

本文介绍如何在 Microsoft Entra 租户中还原软删除的企业应用程序。 软删除的企业应用程序可以在删除后的前 30 天内从回收站中还原。 30 天时段过后,将永久删除企业应用程序且无法还原。

重要

如果通过 Microsoft Entra 管理中心中的应用注册在其主租户中删除了应用程序注册,则还会删除作为其对应服务主体的企业应用程序。 如果通过 Microsoft Entra 管理中心还原已删除的应用程序注册,则还会还原其对应的服务主体。 因此,你将能够恢复服务主体之前的配置,但它之前的策略(例如条件访问策略)不会还原。

先决条件

若要还原企业应用程序,需要:

要恢复最近删除的企业应用程序,请执行以下步骤。 有关删除和恢复应用程序的常见问题的详细信息,请参阅删除和恢复应用程序常见问题解答

使用 Azure AD PowerShell 查看可还原的企业应用程序

重要

请确保使用的是 Azure AD PowerShell 模块。 如果同时安装了 Azure AD PowerShell 模块和 AzureADPreview 模块,则此步骤非常重要。

至少需要云应用程序管理员登录。

  1. 运行以下命令。

    Remove-Module AzureADPreview
    Import-Module AzureAD
    
  2. 连接到 Azure AD PowerShell。

    Connect-AzureAD
    
  3. 运行以下命令以查看最近删除的企业应用程序。

    Get-AzureADMSDeletedDirectoryObject -Id <id>
    

将 ID 替换为要还原的服务主体的对象 ID。

使用 Microsoft Graph PowerShell 查看可还原的企业应用程序

  1. 运行 connect-MgGraph -Scopes "Application.ReadWrite.All"。 至少需要云应用程序管理员登录。

  2. 若要查看最近删除的企业应用程序,请运行以下命令。

    Get-MgDirectoryDeletedItem -DirectoryObjectId <id>
    

将 ID 替换为要还原的服务主体的对象 ID。

使用 Microsoft Graph API 查看可还原的企业应用程序

使用 Graph 浏览器查看和还原最近删除的企业应用程序。 至少需要云应用程序管理员登录。

若要获取租户中已删除企业应用程序的列表,请运行以下查询。

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

从生成的已删除服务主体列表中,记录要还原的企业应用程序的 ID。

或者,如果要获取已删除的特定企业应用程序,请提取已删除的服务主体,并使用以下语法按客户端的应用程序 ID (appId) 属性筛选结果:

https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.servicePrincipal?$filter=appId eq '{appId}'。 检索已删除的服务主体的对象 ID 后,请继续进行还原。

使用 Azure AD PowerShell 还原企业应用程序

  1. 若要还原企业应用程序,请运行以下命令:

    Restore-AzureADMSDeletedDirectoryObject -Id <id>
    

将 ID 替换为要还原的服务主体的对象 ID。

使用 Microsoft Graph PowerShell 还原企业应用程序

  1. 若要还原企业应用程序,请运行以下命令:

    Restore-MgDirectoryObject -DirectoryObjectId <id>
    

将 ID 替换为要还原的服务主体的对象 ID。

使用 Microsoft Graph API 还原企业应用程序

若要还原企业应用程序,请运行以下查询:

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

将 ID 替换为要还原的服务主体的对象 ID。

注意

客户可以查看软删除的托管标识服务主体,但无法将其恢复或永久删除。

警告

永久删除企业应用程序这一操作不可逆。 应用上的任何现有配置都将完全丢失。 仔细查看企业应用程序的详细信息,确保仍要对其执行硬删除。

使用 Azure AD PowerShell 永久删除企业应用程序

若要永久删除软删除的企业应用程序,请运行以下命令:

Remove-AzureADMSDeletedDirectoryObject -Id <id>

使用 Microsoft Graph PowerShell 永久删除企业应用程序

  1. 若要永久删除软删除的企业应用程序,请运行以下命令:

    Remove-MgDirectoryDeletedItem -DirectoryObjectId <id>
    

使用 Microsoft Graph API 永久删除企业应用程序

若要永久删除软删除的企业应用程序,请在 Microsoft Graph 浏览器中运行以下查询。

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

后续步骤