Bulk export of Microsoft Whiteboard boards for tenant admins: what Export-WhiteboardHtml covers
Microsoft's migration support page lists two bulk export cmdlets, Export-WhiteboardHtml and Invoke-WhiteboardHtmlRetry. This page summarizes what Microsoft documents about them and about the other admin cmdlets it names, and where that documentation stops short of the 16 October 2026 deletion of Azure-based whiteboards. It names the cmdlets only; for the command syntax, use Microsoft's reference page listed at the end.
The short answer for admins
- What the cmdlet does: Microsoft's reference describes Export-WhiteboardHtml in these words: "Exports Microsoft Whiteboards to HTML files using the Microsoft Graph API."
- Where it looks: the reference describes reading a user's OneDrive to find and convert whiteboard files. That makes it a bulk export for OneDrive-backed boards.
- What is not confirmed: whether it can reach a board still stored in Azure. The reference describes OneDrive only, while the migration page lists the cmdlet among its migration-related tools. Until you have tested it, treat it as a OneDrive-only bulk export.
- What that means before 16 October 2026: for a board still in Azure, the export Microsoft documents is Settings, then Export image, one board at a time. The steps are on the export steps and dates page.
What Microsoft documents about Export-WhiteboardHtml
The cmdlet has a user mode and an admin mode. Microsoft's wording for each:
- "User mode: exports your own whiteboards (no admin rights needed)."
- "Admin mode: exports whiteboards for all users in a tenant, or a specific subset."
Admin mode needs consent. Microsoft's wording: "Admin mode permissions require admin consent."
Failures the reference describes
- A user is skipped. A user without an active OneDrive is skipped by the bulk export. Microsoft's wording: "The user has never activated OneDrive, or their OneDrive has been deleted. This is expected and not an error."
- A file comes out empty or corrupted. Microsoft's wording: "The whiteboard may be empty or in a format the Graph API cannot convert."
- Some boards fail. Failed exports are retried with the second cmdlet, Invoke-WhiteboardHtmlRetry, run with the same parameters.
- The run is interrupted. Running the same command again resumes it. Microsoft's wording: "It automatically picks up where it left off — users already processed are skipped."
How faithful the HTML export is to the original board is not stated on the Microsoft pages read for this guide.
The admin cmdlets Microsoft lists
Microsoft's migration support page groups these cmdlets of the WhiteboardAdmin PowerShell module by purpose.
| Purpose | Cmdlets Microsoft names |
|---|---|
| Inventory Azure boards and owners | Get-WhiteboardsForTenant, Get-Whiteboard, Get-WhiteboardOwners |
| Transfer ownership | Set-WhiteboardOwner, Invoke-TransferAllWhiteboards |
| Export whiteboards | Export-WhiteboardHtml, Invoke-WhiteboardHtmlRetry |
Microsoft says administrators can check whether their tenant has Azure whiteboards by using Get-WhiteboardsForTenant. That is the first thing to find out: if the tenant has no Azure boards, the 16 October 2026 deletion does not touch its boards.
What admins can no longer do
- Migrate. Migration from Azure to OneDrive ended on 25 September 2026. The migration tool is no longer available, and boards still in Azure became read-only and can no longer be migrated.
- Rely on Microsoft to move the boards. Microsoft did not run a tenant-wide migration. Its wording: "They do not provide a tenant-wide, Microsoft-operated migration of all boards. Migration remains user-driven and client-triggered."
- Recover after the date. Microsoft's wording: "October 16, 2026: Remaining Azure-based Whiteboards are permanently deleted and cannot be recovered." The Azure Whiteboard service itself shuts down on 30 November 2026.
What is still possible: until 16 October 2026 the remaining Azure-based boards can be viewed and exported.
Which boards are in Azure, and boards of people who have left
According to Microsoft's data management article, the boards stored in Azure are the ones originally created in Azure and the ones started on a Surface Hub or a Microsoft Teams Rooms device. OneDrive is the default storage for all new whiteboards.
Azure boards of a former user. Microsoft states that migration could only be triggered by the owner of an Azure whiteboard, which matters for boards owned by people who have left. Microsoft lists Set-WhiteboardOwner and Invoke-TransferAllWhiteboards for transferring ownership.
OneDrive-backed boards of a former user. These are ordinary .whiteboard files in the creator's OneDrive. Microsoft's wording: "To preserve a former user's OneDrive files, including .whiteboard files, first give yourself access to their OneDrive, and then move the files you want to keep." It adds a caution: "However, share links and permissions might not move."
The full runbook for a team or a tenant
The Microsoft Whiteboard rescue pack holds 3 files, the same for every buyer: a runbook as one self-contained HTML file and an alternatives matrix as CSV and as Markdown. The runbook has a section for tenant admins that names only the cmdlets Microsoft lists, a triage to list boards and flag the ones at risk, a printable checklist and a list of what the guide could not confirm.
It does not export anything for you, contains no software and does not reproduce PowerShell command syntax.
Price: $12 (USD), one-time payment, no subscription.
Get the rescue pack on Gumroad for $12
The three files are digital downloads delivered by Gumroad right after payment; nothing is shipped. Gumroad shows the total, with any applicable taxes, before you confirm. Refunds follow the refund policy shown on the Gumroad page.
About this page
- Information as of 2026-10-04, verify with Microsoft: https://support.microsoft.com/en-us/whiteboard/migration-of-whiteboards-from-azure-to-onedrive
- Independent guide, not affiliated with or endorsed by Microsoft or any vendor named. Product names are used only to describe the products.
- AI-generated from the public sources cited. The source pages were retrieved with an automated fetch tool on 2026-10-04 and the guide was generated from the statements recorded from them. It was not written by an IT professional, and the cmdlets were not run for this guide.
- Unsponsored: no affiliate or referral links. This page, the guide and the matrix give every address as the plain public address.
- Informational only. It is not legal, compliance or data-retention advice. Dates and cmdlet behaviour can change.
Microsoft sources used on this page
The addresses are given as plain text. Copy one into your browser to read the original.
- Migration of whiteboards from Azure to OneDrive (dates, export step, admin cmdlets): https://support.microsoft.com/en-us/whiteboard/migration-of-whiteboards-from-azure-to-onedrive
- Export-WhiteboardHtml reference (modes, consent, failures, command syntax): https://learn.microsoft.com/en-us/powershell/module/whiteboardadmin/export-whiteboardhtml?view=whiteboard-ps
- Manage data for Microsoft Whiteboard (OneDrive and Azure storage, former users): https://learn.microsoft.com/en-us/microsoft-365/whiteboard/manage-data-organizations?view=o365-worldwide