logo
search
Exchange Connection Problems

How to Fix Automatic Mapping for On-Premises Mailboxes in Hybrid Exchange

Ayan MasoodAyan Masood Oct 16, 2026 869 views

Question details

The user needs to fix an issue where an on-premises mailbox does not automatically map in Outlook for a user whose primary mailbox is hosted in Exchange Online.

How to Fix Automatic Mapping for On-Premises Mailboxes in Hybrid Exchange
Product
Microsoft Exchange / Outlook
Device & OS
not provided
Scenario
A user with an Exchange Online mailbox has been granted full access to an on-premises mailbox, but it fails to appear in their Outlook client.
Observed behavior
Despite having full access permissions, the automatic mapping feature fails to display the on-premises mailbox in the Outlook interface.
Before you start

Ensure you have administrative privileges to the Exchange Management Shell (EMS) on your on-premises server and that Active Directory synchronization is currently healthy.

Solution 1Recommended

Remove and Reassign Full Access Permissions with Automapping

Resetting the mailbox permissions using the Exchange Management Shell forces the automapping attribute to correctly apply to the user's profile.

In a hybrid Exchange environment, permissions granted through graphical interfaces do not always correctly trigger the Automapping attribute. Using the Exchange Management Shell (EMS) explicitly configures this setting.

1
Launch Exchange Management Shell

Open the Exchange Management Shell as an Administrator on your on-premises Exchange server.

2
Remove existing permissions

Run the command: Remove-MailboxPermission -Identity "SharedMailboxName" -User "UserEmail" -AccessRights FullAccess to clear the current, faulty permission.

3
Reassign with automapping enabled

Run the command: Add-MailboxPermission -Identity "SharedMailboxName" -User "UserEmail" -AccessRights FullAccess -AutoMapping $true to explicitly enable automapping.

4
Wait for synchronization

Allow enough time for Azure AD Connect to synchronize the updated directory attributes to Exchange Online, then have the user restart their Outlook client.

Remove and Reassign Full Access Permissions with Automapping
Synchronization Time: Depending on your AAD Connect sync cycle, it may take up to 30 minutes or more for changes to reflect in the Exchange Online user's Outlook client.
Free Microsoft Office alternative

Looking for a Lightweight Alternative to Microsoft Office?

While resolving advanced IT configurations for Microsoft Exchange and Outlook, you or your users may want a more straightforward, fast, and lightweight productivity suite. WPS Office provides an excellent free alternative that is fully compatible with major Office formats and designed to enhance everyday document workflow without heavy subscription fees.

  1. 1. Visit the WPS Office Website: Go to the official WPS website to find the latest free version for your operating system.
  2. 2. Download the Installer: Click the 'Free Download' button to save the lightweight installation package to your computer.
  3. 3. Install and Start Working: Run the installer, follow the on-screen prompts, and immediately begin managing your documents with full Microsoft format compatibility.
Seamless format compatibility with Microsoft Word, Excel, and PowerPoint (DOCX, XLSX, PPTX)Free to use with no hidden subscription requirementsFamiliar tabbed user interface for easy user migration and onboardingExtremely lightweight installation that runs fast on any Windows, Mac, or Linux device
microsoft office alternative - wps office

Frequently Asked Questions

Why does automapping fail even when a user has Full Access permission?

Automapping can fail if the permission was granted via a method that doesn't trigger the AutoMapping parameter (like certain GUI actions), if the target mailbox is hidden from the Global Address List, or if directory synchronization (AAD Connect) has not yet replicated the change to Exchange Online.

How long does it typically take for automapping to apply in a hybrid Exchange setup?

It typically depends on your Azure AD Connect sync intervals and Outlook client caching. It usually takes anywhere from 30 minutes to a few hours for the synchronized permissions to reflect and automap the mailbox in the user's Outlook client.

Can I manually add the shared on-premises mailbox if automapping isn't working?

Yes. If the user has Full Access permissions, they can bypass automapping by going to File > Account Settings > Account Settings > Change > More Settings > Advanced, and manually adding the mailbox via the 'Add' button.

Does the Test-OutlookWebServices cmdlet work for Exchange Online mailboxes?

Test-OutlookWebServices is primarily used for testing on-premises Exchange Autodiscover and EWS health. For Exchange Online mailboxes, Microsoft provides the Microsoft Remote Connectivity Analyzer tool to test connectivity and Autodiscover resolution.