Share via


Resolve search errors in eDiscovery (Standard)

If you encounter an issue or error that's related to searches in Microsoft Purview eDiscovery (Standard), retry the operation to rule out transient issues. For issues that persist, select the applicable description from the following list:

If none of these resolutions apply to your search issue, contact Microsoft Support. Depending on your issue, gather output by using the Get-ComplianceSearch or Get-ComplianceSearchAction PowerShell cmdlet before you create a support case. For information about other diagnostic information that Microsoft Support might need, see Collect eDiscovery diagnostic information.

For eDiscovery hold issues, see Resolve hold errors in eDiscovery (Standard).

Search issue: Difference between estimated and downloaded search results

Symptoms

When you view the search result statistics in the Export Summary <timestamp>.csv file in the downloaded eDiscovery search results folder, you notice that the estimated and downloaded search result statistics differ. The estimated search result statistics are also shown in the details pane for the search in the Microsoft Purview compliance portal, and in the eDiscovery export tool.

Cause

An estimate of the search results is just that: It's an estimate and not an actual count of items that meet the search query criteria. For more information about why estimated and downloaded search results can differ, see Differences between estimated and actual eDiscovery search results.

Back to top

Search error: "Location is ambiguous"

Symptoms

When you run an eDiscovery search, the search fails and returns the following error message:

The compliance search contains the following invalid location(s): <mailbox identifier>. The location <mailbox identifier> is ambiguous.

Cause

The locations specified in the error message are invalid. The mailbox identifier for each invalid location is used by duplicate or conflicting objects in Exchange Online Protection (EOP).

Resolution

For each invalid location, follow these steps:

  1. Connect to Security & Compliance PowerShell.

  2. Find the duplicate or conflicting objects that use a mailbox identifier. To do this, run the following Get-Recipient command:

    Get-Recipient -Identity "<mailbox identifier from error message>"
    
  3. Remove the duplicate or conflicting object.

Back to top

Search error: "Recipient not found"

Symptoms

Your eDiscovery search fails and returns the error message, "Recipient not found."

Cause

The system can't find one of the recipients in your eDiscovery search because of synchronization delays in Exchange Online Protection (EOP).

Resolution

  1. Connect to Security & Compliance PowerShell.

  2. Check whether the recipients in the search query are synced in EOP by using the Get-Recipient cmdlet. Run the following command:

    Get-Recipient -Identity "<user identifier>" | FL
    
  3. If the command doesn't return a user object for a recipient, wait 30 minutes for synchronization to finish, and then recheck.

  4. After you verify that the recipient has synced in EOP, retry your search.

Back to top

Search error: CS007

Symptoms

Your eDiscovery search fails and returns a CS007 error code.

Cause

Either of the following issues can cause this error:

  • A transient issue

  • A search query that returns too many results for the system to process. For example, a query that uses several wildcards can return a large result set.

Resolution

Retry your search. If your search still fails, split your search into smaller searches. For example, use date ranges or limit the number of search locations to return smaller result sets.

Search error: "Internal server error (500) occurred"

Symptoms

Your eDiscovery search fails and returns the error message, "Internal server error (500) occurred."

Cause

Issues that can cause this error include:

  • A search query that returns too many results for the system to process. For example, a query that uses several wildcards can return a large result set.

  • Other search errors. To check for those errors, run the following command to get information about the search, and then look for error messages in the output:

    Get-ComplianceSearch -Identity <search name> | FL ResultDetails
    

Resolution

Retry your search. If your search still fails, split your search into smaller searches. For example, use date ranges or limit the number of search locations to return smaller result sets.

Back to top

Search or export error: "Maximum number of jobs for your organization are currently running"

Symptoms

When you try to search or export eDiscovery search results, the operation fails and you receive the following error message:

Your request can't be started because the maximum number of jobs for your organization are currently running.

Cause

Your organization has reached the maximum limit of 50 concurrent jobs. Because export jobs typically take longer to finish than search jobs, export jobs are more likely to fill the quota.

Resolution

Use the following procedure to see which export jobs are currently running:

Note

To use the following procedure, you must be a member of the eDiscovery Manager role group and be an eDiscovery administrator in that group. For more information about how to view or assign eDiscovery Administrators in your organization, see Assign eDiscovery permissions, Get-eDiscoveryCaseAdmin, and Add-eDiscoveryCaseAdmin.

  1. Connect to Security & Compliance PowerShell.

  2. Run the following script:

    $date = Get-Date
    $exports = @(Get-ComplianceSearchAction -Export -ResultSize Unlimited)
    $cases = Get-ComplianceCase | ?{$_.status -like "Active"}
    $i = 1
    foreach ($case in $cases) {
      $exports += Get-ComplianceSearchAction -Export -Case $case.Name
      Write-Host "Processing case $($i) of $($cases.Count)"
      $i++
    }
    $inProgressExports = $exports | ?{$_.Results -eq $null -or (!$_.Results.Contains("Export status: Completed") -and !$_.Results.Contains("Export status: none"))}
    $inProgressExportsSince = $inProgressExports | ?{$_.JobStartTime -ge $date.AddDays(-7)} | Sort-Object JobStartTime -Descending
    Write-Host "In-progress export jobs:"
    $inProgressExports | Format-Table Name,JobStartTime,JobEndTime,Status | More
    Write-Host "In-progress export jobs started in the last 7 days:"
    $inProgressExportsSince | Format-Table Name,JobStartTime,JobEndTime,Status | More
    

To resolve the error, use the following procedure:

  1. Reduce the number of jobs that are running. Use one or both of the following approaches:

    • Wait for one or more running jobs to finish.

    • Remove one or more running jobs that you no longer require by using the Remove-ComplianceSearchAction PowerShell cmdlet.

  2. Retry your search or export operation.

Back to top

Export issue: Export appears to be stalled

Symptoms

You try to export eDiscovery search results, but the export doesn't finish, and it appears to be stalled.

Cause

Transient issues can stall the export process.

Resolution

Restart the export.

Note

You can't restart an export of search results that were generated more than seven days earlier. Instead, rerun the search, and then start the export.

Back to top

Export error: "Item has been moved or deleted" or "Unable to retrieve item due to timeout"

Symptoms

After you download eDiscovery search results, you see the following errors in the Export Warnings and Errors.csv file in the downloaded export folder:

  • FailedToExportItem_Microsoft.Exchange.EDiscovery.Export.ExportException: Export failed with error type: 'FailedToExportItem'. Message: Item has been moved or deleted.

  • FailedToExportItem_Microsoft.Exchange.EDiscovery.Export.ExportException: Export failed with error type: 'FailedToExportItem'. Message: Unable to retrieve item due to timeout after multiple retries.

Cause

These "FailedToExportItem" error messages indicate that the system didn't export all search result items. The unexported items are temporary backups that the system created during mailbox archival. Although eDiscovery can search temporary backup items, these items aren't exportable.

Resolution

Wait for the system to retrieve and export the original mailbox items that are associated with the temporary backups.

Back to top

Export error: "Request failed with status code 500" or "500 internal server error"

Symptoms

When you try to export or download eDiscovery search results, you receive one of the following error messages:

  • Request failed with status code 500

  • 500 internal server error

Cause

The issue can occur for any of the following reasons.

Cause 1

You don't have the Export role. The Export role is automatically assigned to members of the eDiscovery Manager role group. The Export role isn't automatically assigned to members of the Organization Management role group.

Cause 2

The error occurs when you try to download exported search results if you're not the admin who exported the search results.

Cause 3

Permissions filters for your user account restrict the mailboxes, storage locations, or content that you can search and export.

Cause 4

The amount of exportable data for your search exceeds 2 TB. The maximum amount of exportable data for a single search is 2 TB. To determine the exportable data size, run the following command:

Get-ComplianceSearch -Identity <search name> | FL Size,SuccessResults,SearchStatistics

Resolution

Choose the resolution that corresponds to the applicable cause.

Resolution 1

If you're a member of the Organization Management role group, add yourself to the eDiscovery Manager role group. You can do that on the Permissions page in the Microsoft Purview compliance portal, or by using the Add-eDiscoveryCaseAdmin PowerShell cmdlet.

Resolution 2

Ask the admin who created the export to complete the download. To find that admin, run the following command:

Get-ComplianceSearchAction -Export -Case <case name> | FL Name,CreatedBy

Resolution 3

For the mailboxes and storage locations that you want to search and export, check whether any permissions filters prevent those actions. If necessary, ask an admin to configure permissions filters.

Resolution 4

Reduce the download size by splitting your search into smaller searches. For example, use date ranges or limit the number of search locations to return smaller result sets.

To check whether the Search, Export, or Preview roles are assigned to the designated administrator account, run the following test in the Microsoft 365 admin center. You must have Global or Compliance administrator permissions to use the following steps.

Note

This diagnostic isn't available for the GCC High or DoD environments, or for Microsoft 365 operated by 21Vianet.

  1. In the Microsoft 365 admin center, select the Run Tests: eDiscovery RBAC check button to populate the associated test:

  2. In the Run diagnostics section, enter the UPN or email address of the user who is trying to run the Search, Export, or Preview task.

  3. Select Run Tests.

  4. If the user doesn't have the necessary eDiscovery roles assigned, assign those roles so that the user can run the desired task.

Back to top

Export error: "File wasn't exported because it doesn't exist" or "File not found"

Symptoms

After you download eDiscovery search results, you see either of the following error messages in the Export Warnings and Errors.csv, Skipped Items.csv, or trace.log files in the downloaded export folder:

  • This file wasn't exported because it doesn't exist anymore. The file was included in the count of estimated search results because it's still listed in the index. The file will eventually be removed from the index, and won't cause an error in the future.

  • FailedToExportItem_Failed to download content. Additional diagnostic info : Microsoft.Office.Compliance.EDiscovery.ExportWorker.Exceptions.ContentDownloadTemporaryFailure: Failed to download from content <document ID> of type Document. Correlation Id: <correlation ID>. ServerErrorCode: -2147024894 ---> Microsoft.SharePoint.Client.ServerException: File Not Found. at Microsoft.SharePoint.Client.ClientRequest.ProcessResponseStream(Stream responseStream) at Microsoft.SharePoint.Client.ClientRequest.ProcessResponse() --- End of inner exception stack trace ---

Cause

You might see this error message if the eDiscovery search includes Microsoft SharePoint Online or Microsoft OneDrive for Business locations. eDiscovery relies on the SharePoint Online index to identify files in both those locations. The error occurs if a user renames, moves, or deletes a file in the search results after the search finishes but before the system updates the SharePoint Online index. You can check whether a file was renamed, moved, or deleted by looking for the file in the applicable SharePoint Online or OneDrive for Business location.

Resolution

To resolve the issue, reindex the SharePoint Online or OneDrive for Business location by using one of the procedures that are provided in Manually request crawling and reindexing of a site, a library or a list. If you want the search results to include the renamed or moved files, rerun the eDiscovery search.

Back to top

Export download issue: Slow download of exported search results

Symptoms

When you download eDiscovery search results, the download takes longer than expected.

Cause

Issues that can cause a slow download include:

  • A large amount of export data. To determine the download size, run the following command:

    Get-ComplianceSearch -Identity <search name> | FL Size,SuccessResults,SearchStatistics
    
  • A higher-than-usual load on the mailbox servers.

  • Other download errors. To check for those errors:

    • Run the following command to get information about an in-progress export. Look for error messages in the command output.

      Get-ComplianceSearchAction | FL Results
      
    • Look for error messages in the trace.log file in the downloaded export folder.

Resolution

To reduce the download size, split your search into smaller searches. For example, use date ranges or limit the number of search locations to return smaller result sets.

Back to top

Export download issue: eDiscovery export tool doesn't download any files

Symptoms

You run the eDiscovery export tool to download eDiscovery search results. However, after the operation finishes, the Estimated Total field in the tool window shows that no files were downloaded.

Cause

The issue can occur for any of the following reasons:

  • Antivirus software on the destination computer blocks the download.

  • You select a download drive that isn't a local drive.

  • You select a destination folder that's either:

    • The download folder of another eDiscovery export.

    • The parent folder of the download folder of another eDiscovery export. Because the export tool saves metadata files in the parent folder, metadata files for different downloads can conflict with one another.

Resolution

Try each of the following methods in the given order until the issue is resolved:

  1. Pause the antivirus scanner on the destination computer, and then retry the download.

  2. Download to a local drive. If necessary, download to a different client computer.

  3. Select a destination folder that doesn't conflict with any concurrent eDiscovery export.

  4. Disable export to a compressed folder, and disable deduplication of Exchange content. If this step resolves the issue, then the cause is probably antivirus software blocking the download or that you tried to download to a remote drive.

Back to top

Export download error: "Search result was not downloaded as it is a folder"

Symptoms

After you download eDiscovery search results, you see the following error message in the Skipped Items.csv file in the downloaded export folder:

This search result was not downloaded as it is a folder or other artifact that can't be downloaded by itself, any items inside the folder or library will be downloaded.

Cause

You might see this error message if your search includes Microsoft SharePoint Online or Microsoft OneDrive for Business locations. The Skipped Items.csv file lists all folders and other skipped items in the search results. The error message typically appears next to folder paths because they're not downloadable items.

Resolution

No resolution is required. You can safely ignore the error message.

Back to top

Export download error: "Cannot access the file 'ExportData.db'"

Symptoms

You run the eDiscovery export tool to download eDiscovery search results, but the download gets stuck or produces zero-byte files. You see the following error message in the trace.log file in the downloaded export folder:

Hit tolerable error, will retry: The process cannot access the file 'ExportData.db' because it is being used by another process.

Cause

The issue can occur if:

  • Antivirus software on the destination computer blocks the download.

  • You select a download drive that isn't a local drive.

  • You select a destination folder that's either:

    • The download folder of another eDiscovery export.

    • The parent folder of the download folder of another eDiscovery export. Because the export tool saves metadata files in the parent folder, metadata files for different downloads can conflict.

Resolution

Try each of the following methods in the given order until the error is resolved:

  1. Pause the antivirus scanner on the destination computer, and then retry the download.

  2. Download to a local drive. If necessary, download to a different client computer.

  3. Select a destination folder that doesn't conflict with any concurrent eDiscovery export.

  4. Disable export to a compressed folder, and disable deduplication of Exchange content. If this step resolves the issue, then the cause is probably antivirus software blocking the download or that you tried to download to a remote drive.

Back to top