|
1 | 1 | --- |
2 | | -title: An invalid policy blocks a SharePoint site deletion |
| 2 | +title: An Invalid Policy Blocks a SharePoint Site Deletion |
3 | 3 | description: Provides a fix for errors that occur when you try to delete a SharePoint or OneDrive site, or delete documents on them. |
4 | 4 | author: Cloud-Writer |
5 | 5 | ms.author: meerak |
6 | 6 | manager: dcscontentpm |
7 | | -ms.date: 12/17/2023 |
| 7 | +ms.date: 07/22/2025 |
8 | 8 | audience: Admin |
9 | 9 | ms.topic: troubleshooting |
10 | 10 | ms.custom: |
@@ -36,36 +36,34 @@ You might experience one of the following scenarios. |
36 | 36 |
|
37 | 37 | > Versions of this item cannot be deleted because it is on hold or retention policy. |
38 | 38 |
|
39 | | -**Scenario 3:** You've excluded or removed a SharePoint or a OneDrive site from a retention policy. More than 24 hours after you make these updates, you try to delete the site or a version of a document on the site. However, the attempt is unsuccessful, and you receive one of the error messages that are mentioned in scenarios 1 and 2. |
| 39 | +**Scenario 3:** You exclude or remove a SharePoint or a OneDrive site from a retention policy. More than 24 hours after you make these updates, you try to delete the site or a version of a document on the site. However, the attempt is unsuccessful, and you receive one of the error messages that are mentioned in scenarios 1 and 2. |
40 | 40 |
|
41 | | -**Scenario 4:** You've excluded or removed a SharePoint or a OneDrive site from an eDiscovery hold. When you try to delete the site, the attempt is unsuccessful, and you receive the error message that is mentioned in scenario 1. |
| 41 | +**Scenario 4:** You exclude or remove a SharePoint or a OneDrive site from an eDiscovery hold. When you try to delete the site, the attempt is unsuccessful, and you receive the error message that's mentioned in scenario 1. |
42 | 42 |
|
43 | 43 | ## Cause |
44 | 44 |
|
45 | | -Each of these error messages is generated when you try to delete a SharePoint or OneDrive site in either of the following situations: |
| 45 | +These error messages are generated when you try to delete a SharePoint or OneDrive site in either of the following situations: |
46 | 46 | - You exclude or remove the site from a retention policy. However, the retention policy is invalid. |
47 | 47 | - The eDiscovery hold is within a 30-day grace period that prevents the site from being deleted. |
48 | 48 |
|
49 | 49 | ## Resolution |
50 | 50 |
|
51 | | -Verify the validity of the retention policy or determine whether the eDiscovery hold is within the grace period. To do this, run the following test in the Microsoft 365 admin center. You must have **Global** or **Compliance** administrator permissions to use these steps. |
| 51 | +Verify the validity of the retention policy or determine whether the eDiscovery hold is within the grace period. To take this action, run the following diagnostic in the Microsoft 365 admin center. You must have at least Compliance Administrator permissions to use these steps. |
52 | 52 |
|
53 | 53 | > [!NOTE] |
54 | 54 | > This diagnostic isn't available for the GCC High or DoD environments, or for Microsoft 365 operated by 21Vianet. |
55 | 55 |
|
56 | | -1. Select the **Run Tests: Invalid Retention or grace eDiscovery Hold** button to populate the associated test in the Microsoft 365 admin center: |
| 56 | +1. Select the **Run Tests: Invalid Retention or grace eDiscovery Hold** button to populate the associated diagnostic in the Microsoft 365 admin center: |
57 | 57 |
|
58 | 58 | > [!div class="nextstepaction"] |
59 | 59 | > [Run Tests: Invalid Retention or grace eDiscovery Hold](https://aka.ms/PillarInvalidRetention) |
60 | 60 |
|
61 | | -2. In the **Run diagnostics** section, either type or copy and paste the URL of the SharePoint or OneDrive site that you want to delete. |
| 61 | +2. In the **Run diagnostics** section, enter the URL of the SharePoint or OneDrive site that you want to delete. |
62 | 62 |
|
63 | 63 | 3. Select **Run Tests**. |
64 | 64 |
|
65 | | -If the test finds an invalid retention policy that might be blocking the deletion, you can choose to remove the policy. |
| 65 | +If the diagnostic finds an invalid retention policy that might be blocking the deletion, you can choose to remove the policy. |
66 | 66 |
|
67 | 67 | If the test finds that the eDiscovery hold is within the 30-day grace period, you can choose to remove the hold. |
68 | 68 |
|
69 | | -## More information |
70 | | - |
71 | | -To resolve the error in Scenario 4, you can use either the diagnostic or the [Invoke-HoldRemovalAction](/powershell/module/exchange/invoke-holdremovalaction) command. This command can remove eDiscovery holds that are invalid, legacy, or within the 30-day grace period. |
| 69 | +**Note**: To manage holds and resolve the error in Scenario 4, use the [Get-CaseHoldPolicy](/powershell/module/exchange/get-caseholdpolicy) command or the Microsoft Purview portal. Make sure that the location is released from the case hold policy before you try to delete the site. If the hold isn't released, use the [Set-CaseHoldPolicy](/powershell/module/exchange/set-caseholdpolicy) command to release it. If the policy can't be found by using the `Get-CaseHoldPolicy` command or the Purview portal, use the [Invoke-HoldRemovalAction](/powershell/module/exchange/invoke-holdremovalaction) command to clean up the orphan hold. |
0 commit comments