Map Existing UM Mailbox Policies to the Cloud

  • Article

Applies to: Office 365 for enterprises

Before you migrate UM-enabled mailboxes from an on-premises Exchange server to the cloud, you have to associate, or map, a cloud-based UM mailbox policy to the on-premises policy that is assigned to the mailboxes. Mapping policies allows the migration process to automatically UM-enable the mailbox in the cloud as part of the move. For more information, see Understand Remote Mailbox Move and UM.

Before you begin

To learn how to install and configure Windows PowerShell and connect to the service, see Use Windows PowerShell in Exchange Online.

Map a cloud-based UM mailbox policy to an on-premises policy

  1. Create a cloud-based UM mailbox policy that maps to your on-premises UM mailbox policy. Here's how: Create a New UM Mailbox Policy

  2. Map your on-premises UM mailbox policy to the new cloud-based UM mailbox policy by running the Set-UMMailboxPolicy cmdlet in your cloud organization. Set-UMMailboxPolicy sets an attribute in your cloud-based policy that maps to your on-premises policy.
    For example, to map UM mailbox policy Policy A on an-premises Exchange server to the cloud-based UM mailbox policy Policy B, run the following command in your cloud-based organization:

    Set-UMMailboxPolicy -identity "Policy B" -SourceForestPolicyNames "Policy A"

    Note   If you create the new cloud-based UM mailbox policy with the same name as the on-premises policy, you don’t need to include the SourceForestPolicyNames parameter, because this parameter automatically includes the policy name.

Map an on-premises UM mailbox policy to a cloud-based policy

When you migrate mailboxes from the cloud to on-premises, you can map an on-premises UM mailbox policy to a cloud-based UM mailbox policy by running a similar command on-premises, for example:

Set-UMMailboxPolicy -identity "Policy B" -SourceForestPolicyNames "Policy A"