SharePoint and OneDrive Items May Not Be Displayed
| KB ID: | 4704 |
| Product: | Veeam Backup for Microsoft 365 | 8 |
| Published: | 2025-01-23 |
| Last Modified: | 2025-03-19 |
- The solution provided in this article requires Veeam Backup for Microsoft 365 8.1 or higher.
- The issue discussed in this article only occurs under particular circumstances. Review the Cause section closely.
- This article is marked as related to Veeam Backup for Microsoft 365 8 because that is the version that caused the issue.
Challenge
Cause
Retention applied to a Jet-based backup repository containing SharePoint and OneDrive data may mistakenly remove the parent folders from all historical backup databases, leaving their child items orphaned. The issue may only occur under the following conditions:
- The initial backup was created in 2023 or earlier and continued in 2024.
and
- The backups are stored in a JET-based Backup Repository that uses the Snapshot-based retention policy.
and
- The Veeam Backup for Microsoft 365 deployment was at some point running version 7 or 7a (builds 7.x) and subsequently upgraded to one of the following version 8 builds:
- 8.0.2.159
(released 2024-09-03) - 8.0.2.200
(released 2024-09-11) - 8.0.3.1044
(released 2024-10-08) - 8.0.3.1073
(released 2024-10-16)
- 8.0.2.159
Solution
- Identify potentially impacted repositories according to the conditions in the Cause section.
- Open an Administrative PowerShell terminal and use the following command to get a list of impacted sites and OneDrive accounts in each of the impacted repositories:
- For each site and OneDrive listed in the output of the script from the Step 2:
- Identify the backup jobs associated with the impacted sites and OneDrives.
- Run a full synchronization cycle for each job containing impacted objects.
Use the following PowerShell cmdlet:
Replace JobName with the name of the affected job.
During the full backup run, Veeam Backup for Microsoft 365 will automatically repair the issue in the latest and subsequent restore points for impacted objects that are still present within the production Microsoft 365 environment.
- To enable exploring of the individual items without parent folders on older restore points (created before the latest full backup), perform the following steps on the proxy associated with the impacted backup repository:
- Stop all backup jobs on the proxy and the Veeam Backup for Microsoft 365 Proxy Service service.
- On the machine where your backup proxy is installed, navigate to:
C:\ProgramData\Veeam\Backup365\ - Make a copy of the
Proxy.xmlfile, just in case changes need to be reverted or a misconfiguration occurs. - Open the
Proxy.xmlfile, and within the<Archiver>section, add the following line under the RepositoryConfig node:<RepositoryConfig SPJetMissingParentItemsInRoot="true" />
Example end of theProxy.xmlfile:... <RepositoryConfig SPJetMissingParentItemsInRoot="true" /> </Archiver> </Veeam>
- Save the updated
Proxy.xmlfile. - Start the Veeam Backup for Microsoft 365 Proxy Service service.
If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.