Delete a tenant in Microsoft Entra ID
When an organization (tenant) is deleted in Microsoft Entra ID, all resources in the organization are also deleted. Prepare your organization by minimizing its associated resources before you delete. Only a Global Administrator can delete a Microsoft Entra organization from the Microsoft Entra Admin center.
Prepare the organization
You can't delete an organization in Microsoft Entra ID until it passes several checks. These checks reduce the risk that deleting a Microsoft Entra organization negatively affects user access, such as the ability to sign in to Microsoft 365 or access resources in Azure. For example, if the organization associated with a subscription is unintentionally deleted, users can't access the Azure resources for that subscription.
Check the following conditions:
You've paid all outstanding invoices and amounts due or overdue.
No users are in the Microsoft Entra tenant, except one Global Administrator who will delete the organization. You must delete any other users before you can delete the organization.
If users are synchronized from on-premises, turn off the sync first. You must delete the users in the cloud organization by using the Microsoft Entra admin center or Azure PowerShell cmdlets.
No applications are in the organization. You must remove any applications before you can delete the organization.
No multifactor authentication providers are linked to the organization.
No subscriptions for any Microsoft Online Services offerings (such as Azure, Microsoft 365, or Microsoft Entra ID P1 or P2) are associated with the organization.
For example, if a default Microsoft Entra tenant was created for you, you can't delete this organization if your subscription still relies on it for authentication. You also can't delete a tenant if another user has associated a subscription with it.
Note
Microsoft is aware that customers with certain tenant configurations might be unable to successfully delete their Microsoft Entra organization. We're working to address this problem. If you need more information, contact Microsoft support.
Delete the organization
Sign in to the Microsoft Entra admin center as a Global Administrator.
Select Microsoft Entra ID.
On a tenant's Overview page, select Manage tenants.
Select the checkbox for the tenant that you want to delete, and then select Delete.
If your organization doesn't pass one or more checks, you'll get a link to more information on how to pass. After you pass all checks, select Delete to complete the process.
Deprovision subscriptions to allow organization deletion
When you configured your Microsoft Entra organization, you might have also activated license-based subscriptions for your organization, like Microsoft Entra ID P2, Microsoft 365 Business Standard, or Enterprise Mobility + Security E5. To avoid accidental data loss, you can't delete an organization until the subscriptions are fully deleted. The subscriptions must be in a Deprovisioned state to allow organization deletion. An Expired or Canceled subscription moves to the Disabled state, and the final stage is the Deprovisioned state.
For what to expect when a trial Microsoft 365 subscription expires (not including paid Partner/CSP, Enterprise Agreement, or Volume Licensing), see the following table. For more information on Microsoft 365 data retention and subscription lifecycle, see What happens to my data and access when my Microsoft 365 for business subscription ends?.
Subscription state | Data | Access to data |
---|---|---|
Active (30 days for trial) | Data is accessible to all. | Users have normal access to Microsoft 365 files or apps. Admins have normal access to the Microsoft 365 admin center and resources. |
Expired (30 days) | Data is accessible to all. | Users have normal access to Microsoft 365 files or apps. Admins have normal access to the Microsoft 365 admin center and resources. |
Disabled (30 days) | Data is accessible to admins only. | Users can't access Microsoft 365 files or apps. Admins can access the Microsoft 365 admin center but can't assign licenses to or update users. |
Deprovisioned (30 days after Disabled) | Data is deleted (automatically deleted if no other services are in use). | Users can't access Microsoft 365 files or apps. Admins can access the Microsoft 365 admin center to purchase and manage other subscriptions. |
Delete an Azure subscription
If you have an active or canceled Azure subscription associated with your Microsoft Entra tenant, you can't delete the tenant. After you cancel, billing is stopped immediately. After you cancel a subscription, your billing stops immediately. You can delete your subscription directly using the Azure portal seven days after you cancel it, when the Delete subscription option becomes available. Once your subscription is deleted. Microsoft waits 30 to 90 days before permanently deleting your data in case you need to access it or reactivate your subscription. We don't charge you for retaining this data. To learn more, see Microsoft Trust Center - How we manage your data.
If you have a trial or pay-as-you-go subscription. You can delete your subscription three days after you cancel it, when the Delete subscription option becomes available. For details, read through Delete trial or pay-as-you-go subscriptions.
All other subscription types are deleted only through the subscription cancellation process. In other words, you can't delete a subscription directly unless it's a trial or pay-as-you-go subscription.
Alternatively, you can move the Azure subscription to another tenant. When you transfer billing ownership of your subscription to an account in another tenant, you can move the subscription to the new account's tenant. Performing a Switch Directory action on the subscription wouldn't help, because the billing would still be aligned with the Microsoft Entra tenant that was used to sign up for the subscription. For more information, review Transfer a subscription to another Microsoft Entra tenant account.
After you have all the Azure, Office 365, and Microsoft 365 subscriptions canceled and deleted, you can clean up the rest of the things within a Microsoft Entra tenant before you delete it.
Remove enterprise apps that you can't delete
A few enterprise applications can't be deleted in the Microsoft Entra admin center and might block you from deleting the tenant.
Warning
This code is provided as an example for demonstration purposes. If you intend to use it in your environment, consider testing it first on a small scale, or in a separate test organization. You may have to adjust the code to meet the specific needs of your environment.
Use the following PowerShell code to remove those applications:
Install the Microsoft Graph PowerShell module by running the following command:
Install-Module Microsoft.Graph
Install the Az PowerShell module by running the following command:
Install-Module -Name Az
Create or use a managed administrative account from the tenant that you want to delete. For example:
newAdmin@tenanttodelete.partner.onmschina.cn
.Open PowerShell and connect to Microsoft Entra ID by using admin credentials with the following command:
Connect-MgGraph
Warning
You must run PowerShell by using admin credentials for the tenant that you're trying to delete. Only homed-in admins have access to manage the directory via Powershell. You can't use guest user admins, Microsoft accounts, or multiple directories.
Before you proceed, verify that you're connected to the tenant that you want to delete with the Microsoft Graph PowerShell module. We recommend that you run the
Get-MgDomain
command to confirm that you're connected to the correct tenant ID andpartner.onmschina.cn
domain.Run the following commands to set the tenant context. DO NOT skip these steps or you run the risk of deleting enterprise apps from the wrong tenant.
Clear-AzContext -Scope CurrentUser Connect-AzAccount -Environment AzureChinaCloud -Tenant <object id of the tenant you are attempting to delete> Get-AzContext
Warning
Before you proceed, verify that you're connected to the tenant that you want to delete with the Az PowerShell module. We recommend that you run the
Get-AzContext
command to check the connected tenant ID andpartner.onmschina.cn
domain. Do NOT skip the above steps or you run the risk of deleting enterprise apps from the wrong tenant.Run the following command to remove any enterprise apps that you can't delete:
Get-MgServicePrincipal | ForEach-Object { Remove-MgServicePrincipal -ObjectId $_.Id }
Run the following command to remove applications and service principals:
Get-MgServicePrincipal | ForEach-Object { Remove-MgServicePrincipal -ServicePrincipalId $_.Id }
Run the following command to disable any blocking service principals:
$ServicePrincipalUpdate =@{ "accountEnabled" = "false" } Get-MgServicePrincipal | ForEach-Object { Update-MgServicePrincipal -ServicePrincipalId $_.Id -BodyParameter $ServicePrincipalUpdate }
Sign in to the Microsoft Entra admin center as a Global Administrator., and remove any new admin account that you created in step 3.
Retry tenant deletion from the Microsoft Entra admin center.
Handle a trial subscription that blocks deletion
There are self-service sign-up products like Power BI, Azure Rights Management (Azure RMS), Microsoft Power Apps, and Dynamics 365. Individual users can sign up via Microsoft 365, which also creates a guest user for authentication in your Microsoft Entra organization.
These self-service products block directory deletions until the products are fully deleted from the organization, to avoid data loss. Only the Microsoft Entra admin can delete them, whether the user signed up individually or was assigned the product.
There are two types of self-service sign-up products, in terms of how they're assigned:
- Organizational-level assignment: a Microsoft Entra administrator assigns the product to the entire organization. A user can actively use the service with the organizational-level assignment, even if the user isn't licensed individually.
- User-level assignment: An individual user during self-service sign-up essentially self-assigns the product without an admin. After an admin starts managing the organization, the admin can directly assign the product to users without self-service sign-up.
When you begin the deletion of a self-service sign-up product, the action permanently deletes the data and removes all user access to the service. Any user who was assigned the offer individually or on the organization level is then blocked from signing in or accessing any existing data. If you want to prevent data loss with a self-service sign-up product like Power BI dashboards or Azure RMS policy configuration, ensure that the data is backed up and saved elsewhere.
For more information about currently available self-service sign-up products and services, see Available self-service programs.
For what to expect when a trial Microsoft 365 subscription expires (not including paid Partner/CSP, Enterprise Agreement, or Volume Licensing), see the following table. For more information on Microsoft 365 data retention and subscription lifecycle, see What happens to my data and access when my Microsoft 365 for Business subscription ends?.
Product state | Data | Access to data |
---|---|---|
Active (30 days for trial) | Data is accessible to all. | Users have normal access to self-service sign-up products, files, or apps. Admins have normal access to the Microsoft 365 admin center and resources. |
Deleted | Data is deleted. | Users can't access self-service sign-up products, files, or apps. Admins can access the Microsoft 365 admin center to purchase and manage other subscriptions. |
Delete a self-service sign-up product
You can put a self-service sign-up product like Power BI or Azure RMS into a Delete state to be immediately deleted in the Microsoft Entra admin center:
Note
If you're trying to delete the Contoso organization that has the initial default domain contoso.partner.onmschina.cn
, sign in with a UPN such as admin@contoso.partner.onmschina.cn
.
Sign in to the Microsoft Entra admin center as a Global Administrator.
Select Microsoft Entra ID.
Select Licenses, and then select Self-service sign-up products. You can see all the self-service sign-up products separately from the seat-based subscriptions. Choose the product that you want to permanently delete. Here's an example in Power BI:
Select Delete to delete the product. This action will remove all users and remove organization access to the product. A dialog warns you that deleting the product will immediately and irrevocably delete data. Select Yes to confirm.
A notification tells you that the deletion is in progress.
The self-service sign-up product state has changed to Deleted. Refresh the page, and verify that the product is removed from the Self-service sign-up products page.
After you've deleted all the products, sign in to the Microsoft Entra admin center again. Confirm that no required actions or products are blocking your organization deletion. You should be able to successfully delete your Microsoft Entra organization.