Retention: Resolve Errors in Microsoft 365 Retention and Retention Label Policies

 






Error: Settings Not Found

Symptoms

While checking the details pane for a retention policy in the Microsoft Purview portal, an error message appear, "Settings not found." 

Cause

The retention policy has no retention rules.

Resolution

To resolve this issue, use either of the following methods.

Method 1: Use the Microsoft Purview Portal
  • In the Microsoft Purview portal, search for the policy on the following tabs- 

  1. Data Lifecycle Management > Microsoft 365 > Retention policies
  2. Data Lifecycle Management > Microsoft 365 > Label policies
  3. Records Management > Label policies 

  • Select the policy, and then select Edit.
  • In Retention settings, add rules to the retention policy.

Method 2: Use PowerShell

  • Connect to Security & Compliance PowerShell.
  • Use the applicable cmdlet for the workload to add rules to the retention policy.  

Use the New-RetentionComplianceRule cmdlet for policies that target-

  1. Microsoft Exchange Online email
  2. Microsoft SharePoint sites
  3. Microsoft OneDrive accounts
  4. Microsoft 365 Groups
  5. Microsoft Skype for Business conversations
  6. Exchange Online public folders
  7. Microsoft Teams chat messages
  8. Teams channel messages

Error: Something Went Wrong

Symptoms

When the details pane is checked for a policy in the Microsoft Purview portal, the error message, "Something went wrong" appears. 

Run the following command, PolicyNotifyError can be seen in the value returned by the DistributionResults property:

Get -RetentionCompliancePolicy -Identity "<policy name>" -DistrbutionDetail | Select  -ExpandProperty DistributionResults

Cause

An unspecified error occurred in the notification pipeline of the policy sync and distribution process. 

Resolution

Use any of the following methods to resolve this issue:

Method 1: Use the Microsoft Purview portal

  • In the Microsoft Purview portal, search for the policy on the following tabs- 
      1. Data Lifecycle Management > Microsoft 365 > Retention policies
      2. Data Lifecycle Management > Microsoft 365 > Label policies
      3. Records Management > Label policies

    •  To open the policy details pane, select the policy. Make sure to select the policy name and the corresponding checkbox. Otherwise, the details pane will not open.

    • In the policy details pane, select Retry. The policy enters a pending state until policy sync and distribution finishes. 

    Method 2: Use PowerShell

    • Connect to Security & Compliance PowerShell.
    • Retry policy sync and distribution. Use the Set-RetentionCompliancePolicy cmdlet along with the RetryDistribution switch to redeploy the policy-

    Set -RetentionCompliancePolicy -Identity "<policy name>" -RetryDistribution

    Error: Your Policy is Stuck in PendingDeletion

    Symptoms

    While trying to delete a policy, the operation fails.

    Cause

    An unspecified error occurred while trying to delete a policy.

    Resolution
    • Connect to Security & Compliance PowerShell.
    • Remove the policy. Use the Remove-RetentionCompliancePolicy cmdlet along with the ForceDeletion switch-

    Remove -RetentionCompliancePolicy -Identity "<policy name>" -ForceDeletion


    Conclusion

    Some errors in Microsoft 365 Retention and Retention Label Policies are resolved. 















    Comments

    Popular posts from this blog

    Deployment (Part 3)

    Deployment (Part 1)

    Design Planning (Part 3)