logo
search
Exchange Connection Problems

Fix Exchange Set-SyncMailbox Error After Converting to Shared Mailbox

Maira MehtabMaira Mehtab Sep 22, 2026 869 views

Question details

Administrators encounter an UnknownError when running the Set-SyncMailbox cmdlet after converting a licensed user mailbox to an unlicensed shared mailbox.

Product
Exchange Online
Device & OS
not provided
Scenario
Converting a standard user mailbox to a shared mailbox and subsequently removing the user's Microsoft 365 license.
Observed behavior
The Exchange Set-SyncMailbox cmdlet fails and returns an UnknownError, preventing successful synchronization between Microsoft Entra ID and Exchange Online.
Before you start

Ensure you have Exchange Administrator or Global Administrator privileges in Microsoft 365, and verify that the mailbox conversion process has fully completed in the Exchange Admin Center.

Solution 1Recommended

Reset the Shared Mailbox Account Password

Resetting the associated account password forces a synchronization update in Microsoft Entra ID and is the most effective way to resolve the UnknownError.

Even though shared mailboxes do not require a direct login, they still possess an underlying disabled user account in Microsoft Entra ID. When a license is removed during conversion, this account can sometimes fall out of sync with Exchange Online. Resetting the password manually triggers an immediate directory synchronization.

1
Access Active Users

Log in to the Microsoft 365 Admin Center, expand the 'Users' menu on the left sidebar, and click on 'Active users'.

2
Locate the Mailbox Account

Search for the username associated with the newly converted shared mailbox and click on the display name to open the properties panel.

3
Reset the Password

Click the 'Reset password' key icon at the top of the user panel. Choose to either auto-generate a password or create a custom one, then click 'Reset password' to apply the change.

4
Verify Synchronization

Wait a few minutes for the password reset to trigger a sync cycle, then re-run the Set-SyncMailbox cmdlet in Exchange Online PowerShell to confirm the error is gone.

Successful Sync: Because the shared mailbox account remains disabled for direct sign-in, changing this password will not affect how delegated users access the shared mailbox.
Free Microsoft Office alternative

Boost Productivity with a Free Microsoft Office Alternative

While you are managing Exchange servers and Microsoft 365 admin tasks, you might be looking for a fast, reliable, and cost-effective office suite for your local document workflows. WPS Office provides a powerful, lightweight alternative to Microsoft Office with seamless format compatibility.

  1. 1. Download the Installer: Visit the official WPS Office website and click the Free Download button tailored for your operating system.
  2. 2. Install WPS Office: Run the downloaded installation file and follow the brief on-screen instructions to set up the software.
  3. 3. Start Creating Documents: Open WPS Office to instantly start creating, editing, and sharing Word, Excel, and PowerPoint files natively.
Fully compatible with Microsoft Office formats (.docx, .xlsx, .pptx) without formatting lossLightweight application that runs smoothly on Windows, Mac, and Linux environmentsFamiliar, tabbed user interface requiring zero learning curve for rapid migrationFree built-in PDF editing, merging, and format conversion tools
QA img-9

Frequently Asked Questions

Why does Set-SyncMailbox fail with UnknownError after removing a license?

When a Microsoft 365 license is removed immediately after converting a mailbox, backend mismatches can occur between Microsoft Entra ID and Exchange Online. The system struggles to resolve the mailbox's new licensing state during the sync phase, which triggers the UnknownError.

How long does it take for a shared mailbox conversion to propagate in Microsoft 365?

In cloud-only Microsoft 365 setups, mailbox conversions and license removal changes typically take 15 to 30 minutes to fully propagate. In hybrid environments, the timeframe depends on your Microsoft Entra Connect synchronization schedule, which is usually every 30 minutes by default.

Do shared mailboxes require a Microsoft 365 license?

Shared mailboxes with a storage capacity of up to 50 GB do not require a Microsoft 365 license. However, if the shared mailbox exceeds 50 GB, or if you need to enable an In-Place Archive or Litigation Hold, an Exchange Online Plan 2 license must be assigned.