Delete items in the Recoverable Items folder in Exchange Online

One of the customers I work with apply extensive retention policies for mailboxes in the organization. A restrictive policy applied to a mailbox receiving a lot of messages with attachments will likely cause incidents where the recoverable items quota is exceeded.

In this case the root cause is retention policies but this could also be caused by litigaton hold, eDiscovery case holds etc. This article assumes it is OK to remove these policies and hard deleting the messages. If these messages need to be retained.

Before proceeding, verify that the quota is exceeded by running the below command. Mailboxes on hold have a default recoverable item quota of 100 GB.

Get-MailboxStatistics <PrimarySMTPAddress> | ft DisplayName, TotalDeletedItemSize, DeletedItemCount

Preparations

Before proceeding we need to make sure that messages can be deleted from the mailbox. This involves changing some settings for the mailbox. The following command will disable deleted item retention and single item recovery for the mailbox.

Set-Mailbox <PrimarySMTPAddress> -RetainDeletedItemsFor 0
Set-Mailbox <PrimarySMTPAddress> -SingleItemRecoveryEnabled $false

You also need to ensure the mailbox is no longer affected by any holds. Microsoft explains this in detail in this article. Note that a applied retention policy starting with a minus sign means the mailbox is excluded from the policy.

As changes related to retention / holds usually take a long time to apply in large organizations I recommend waiting 24 hours before proceeding.

Deleting the items

To delete the items I grant my account access to the mailbox in question and setup a new Outlook profile for the task. I configure the profile not to use cached Exchange mode and close the Outlook client as soon as the target mailbox becomes avaialble.

Using MFCMAPI I proceed with deletion of the contents of the DiscoveryHolds folder:

  1. Start the application and select “Session” -> “Logon…”
  2. Select the newly created Outlook profile and click “OK”.
  3. Double-click the target mailbox in the list of available mailboxes.
  4. Expand the mailbox and the “Recoverable Items” folder.
  5. Right-click “DiscoveryHolds” and select “Advanced” -> “Empty items and subfolders from folder…”
  6. Check the “Hard Deletion” box and click “OK”.

The deletion process should start immediately you should see the ItemsInFolder and FolderAndSubfolderSize changing when running the command below.

Get-MailboxFolderStatistics -Identity <PrimarySMTPAddress> -FolderScope RecoverableItems | ft Identity, ItemsInFolder, FolderAndSubfolderSize

When you’re happy with the results verify that you’re under the recoverable item quota by running this again.

Get-MailboxStatistics <PrimarySMTPAddress> | ft DisplayName, TotalDeletedItemSize, DeletedItemCount

It everything looks OK make sure to re-apply the single item recovery and deleted item retention settings. Below are commands to restore defaults.

Set-Mailbox <PrimarySMTPAddress> -RetainDeletedItemsFor 14
Set-Mailbox <PrimarySMTPAddress> -SingleItemRecoveryEnabled $true

Possible issues

If deleting the items only results in the items being moved from “DiscoveryHolds” to “Purges” it most likely means the item retention and single items recovery settings are not fully applied. Wait some time and run the below command.

Start-ManagedFolderAssistant -Identity <PrimarySMTPAddress>

Update: 2021-09-07: Another reason message may be getting stuck in Purges is the mailbox property ElcProcessingDisabled being set to True. Microsofts own documentation suggest that’s the way it should be done but my experience is that setting it to false may resolve this issue (thanks for verifying Michael).

Set-Mailbox -Identity <PrimarySMTPAddress> -ElcProcessingDisabled $false
Start-ManagedFolderAssistant -Identity <PrimarySMTPAddress>

40 thoughts on “Delete items in the Recoverable Items folder in Exchange Online”

  1. Hi, thank you for effort on doing this post. I tried to follow these steps, but I ended up with following error in MFCMAPI:

    Warning:
    Code: MAPI_W_PARTIAL_COMPLETION == 0x00040680
    Function lpMAPIFolderToEmpty->EmptyFolder( lpProgress ? reinterpret_cast(m_hWnd) : NULL, lpProgress, ulFlags)
    File D:\a\1\s\UI\Dialogs\HierarchyTable\MsgStoreDlg.cpp
    Line 719

    1. Hi,

      I’m afraid I haven’t encountered that error. Did you find a way to get it to work?

      1. Please try after unchecking the cached mode. somehow purge works on online mode though it takes time.

    2. Are you sure the offending mailbox has been removed from all retention policies? I was running into this and forgot to remove the offending mailbox from a retention policy once I did this it worked.

  2. Ran into the same… The trouble is a a “Chicken and the eggs” I suspect… When deleting stuuf, in goes in the Recovery, but dleleting from the but’s it in the PURGE.
    I hard deleted the purge, and things started emptying itself BOTH in purge and Recovery…
    Also of note, don’t forget the delay if you had to make yourself a member of the necessary security/compliance groups.

    1. Hey, I was wondering how you deleted the purge. I am having the same issue. Did you do via Mapi? I can’t see Purge in the menu.

  3. After countless Microsoft articles *and* hours on the phone with them, I somehow came across this site and it was the first with decent instructions and the only one THAT WORKED! Boss’s DiscoveryHolds folder was full at 100GB and I been losing sleep over trying to empty or expand it.
    Thank you Martin!

    1. That’s awesome, happy to hear that this helps people in the real world! Thanks for sharing 🙂

  4. This didn’t work for me. Emails simply got stuck in Purges

    Running Start-ManagedFolderAssistant -Identity did nothing either. Yesterday this command simply moved them back to DiscoveryHolds but today it does nothing and I can’t delete the purges folder and I can’t delete any emails within the Purges folder. I went through the MS guide and tried the Powershell commands with no success either. Our customer is stuck being unable to delete emails.

    1. Try changing the value (true/false) of the setting “ElcProcessingDisabled” for the mailbox using Set-Mailbox. I’ve had issues with messages stuck in purges from time to time and I have something like the above in my notes. Hope it helps and please let me know if it does so that this can be added to the post.

      1. Setting this to False worked. I worked with Microsoft tech on Friday afternoon who pointed this out. In Microsoft’s guide it says to set it to true so that’s where the confusion was.

        1. Thanks for sharing, I’ve updated the article with this now verified piece of info 🙂

        2. Were you able to flush out purges using the mfcmapi? I have a mailbox on which elc is false, i flushed disc holds using mfcmapi but all the 99gb of disc holds are now stuck in Purges and purges is not cleaning up using mfcmapi. Hard deletion not working.

    1. Are you trying to delete something you have already attempted to delete, because it visually didn’t look like it was deleting?

      I think that error means its processing your first request.
      A refresh of the folder may show it has been deleted.

  5. This article is by far the most clear instruction to cleanup Recoverable Items folder, thanks Martin. The issue I have encountered is the MFCMAPI part, it’s just stuck at “Not Responding” and did nothing while was trying to empty 100GB DiscoveryHolds folder, any idea?

    1. Thank you for those kind words, Sander! Are you sure things aren’t happening in the background when MFCMAPI is “Not responding”? I’ve encountered it quite frequently in these scenarios but by repeatedly running “Get-MailboxFolderStatistics -Identity -FolderScope RecoverableItems | ft Identity, ItemsInFolder, FolderAndSubfolderSize” over and over again you can usually see if there is any progress.

        1. The same has been happening for me, MFCMapi hangs after trying clicking OK when selecting hard delete. Event Viewer immediately reports the application has hung. I suspect some update to M365’s MAPI processing may have broken this functionality, possibly specifically for Recoverable Items.

          1. Just wanted to say same is happening for me as well, just freezes as soon as I click ‘ok’ after hard delete and checking the mailboxfolderstatistics I’m not seeing any changes in the numbers, have left it for a few hours just in case but seems proper frozen.

  6. What about if I have retention policy for 1 year (only retain mode).
    I want to delete only these messages older than one year from Discovery Holds?

    1. Haven’t tried that but based on how retention work my guess would be that it works as expected.

  7. I’ve been using this guide for a while, sometimes I’ve waiting a few days and something just starts kicking it off, today I’ve found something that seems to have kicked the process in.

    Check in complainace.microsoft.com to see if you have any settings in Data lifecycle management, I found a retention policy that was set to keep data in exchange for 3 years, by excluding the mailbox in this setting MFCMAPI has started to remove the items.

    I hope this helps anyone with the same issue

    1. I believe I have tracked down my issue to (2) InPlaceHolds being the issue as to why MFCMAPI won’t delete files. I can’t find anywhere online that says how long does it take for the user mailbox to be excluded from the Retention Policies? I feel like certain portals say up to 4 hours and others say wait 24 hours!

      The weird issue with this user is she can’t edit her Calendar items and I believe it is due to her old Litigation folders in the background exceeding 100GB.

      Identity ItemsInFolder FolderAndSubfolderSize
      ——– ————- ———————-
      mcollins\Recoverable Items 0 99.81 GB (107,170,040,668 bytes)
      mcollins\Audits 5740 27.86 MB (29,214,345 bytes)
      mcollins\Calendar Logging 0 0 B (0 bytes)
      mcollins\Deletions 0 0 B (0 bytes)
      mcollins\DiscoveryHolds 10 573.8 KB (587,535 bytes)
      mcollins\Purges 13873 80.32 GB (86,240,579,414 bytes)
      mcollins\SubstrateHolds 2326 252.6 MB (264,862,375 bytes)
      mcollins\Versions 8541 19.22 GB (20,634,796,999 bytes)

      This is where I’m at hurdle-wise. I have excluded the user mailbox from these to retention policies (I believe anyway!) and I’m still stuck. Help if you can please! I’ve been at this for 2 days now.

      LitigationHoldEnabled : False
      InPlaceHolds : {-mbx7e36da76278a42f793c1eeb0c614196a, -mbxb0d8e7e47eb94b92ac3951275be341f2}

  8. This worked great and even Microsoft support didn’t have this as an option to resolve the issue (they wanted to delete the mailbox as next steps).

    Please note that I didn’t see the recoverable items folder but found in this video some settings that fixed this issue.

    https://www.youtube.com/watch?v=CVvXGfGxml8 (see notes for option settings)

  9. Hi,

    as others seeking help with deleting items in the Recoverable Items folder, I came across this article, and I appreciate all the very useful information.

    However, I can’t see the “Recoverable Items” folder when expanding the IPM_SUBTREE.

    I see all the usual folders but none of the “hidden” folders.

    What am I doing wrong?

    1. It’s possible that you havent created a test outlook profile that is set to not be in cached mode?
      Also I found that if the user has their outlook open at the same time as MFCMapi then you will not see all the folders.

  10. Once the items are moved to Purge folder what would be the next step?
    Can I empty the purge folder or the items delete by themselves after some time? (All recommended commands here ran, no holds whatsoever)

  11. For anyone who is trying this and regularly running ManagedFolderAssistant I put together this code to run, loop and output when it’s finished:

    $mfaruntime=get-date
    write-host -NoNewline “Running MFA $mfaruntime ”
    Start-ManagedFolderAssistant -Identity

    do {
    start-sleep -Seconds 2
    write-host “.” -NoNewline

    $log=Export-MailboxDiagnosticLogs -Identity abradley@urbanest.co.uk -ExtendedProperties
    $xml = [xml]($Log.MailboxLog)
    $xmllastsuccesstime=[datetime]::ParseExact(($xml.Properties.MailboxTable.Property | ?{ $_.Name -eq “ELCLastSuccessTimestamp” } | % Value),’M/d/yyyy h:mm:ss tt’, $null)
    } until ($xmllastsuccesstime -gt $mfaruntime)
    write-host “#”
    $xml.Properties.MailboxTable.Property | ? {$_.Name -in (“ElcLastRunTotalProcessingTime”,”ELCLastSuccessTimestamp”)}| ft -AutoSize

    Get-MailboxFolderStatistics -Identity “$ExchangeGUID” -IncludeAnalysis -FolderScope RecoverableItems | Format-Table Name,ItemsInFolder,FolderSize,*Subject*

  12. Followed the instructions but now all the emails got moved from the “DiscoveryHolds” folder into the “Purges” folder

    Do you know how long the wait time before running the below command again?

    Start-ManagedFolderAssistant -Identity

    24hrs?

  13. Hi there, I followed the step and probably didn’t leave enough time for the item retention and single items recovery settings to fully applied. Therefore I ran the command Start-ManagedFolderAssistant -Identity. However now I can see increase in the DiscoveryHolds. It is now 100GB. Would you know how I can resolve this?

  14. I have a users mailbox that has 104.7GB in the Recoverable items folder that I’ve been trying to delete as they can no longer delete items from their primary mailbox. I’ve followed the steps in the above article and the items in the article linked below but I get an error in the MAPI program every time I try to run it. I am using my outlook in online mode not cached mode currently and I checked that the user was removed form all of the retention policies in our organization.

    Has anyone else run across an error like this one?

    The error code is: Warning:
    Code: MAPI_W_PARTIAL_COMPLETION == 0x00040680
    Function lpMAPIFolderToEmpty->EmptyFolder( lpProgress ? reinterpret_cast(m_hWnd) : NULL, lpProgress, ulFlags)
    File D:\a\1\s\UI\Dialogs\HierarchyTable\MsgStoreDlg.cpp
    Line 717

    https://learn.microsoft.com/en-us/microsoft-365/compliance/ediscovery-delete-items-in-the-recoverable-items-folder-of-mailboxes-on-hold?view=o365-worldwide#step-3-remove-all-holds-from-the-mailbox

Leave a Reply

Your email address will not be published. Required fields are marked *