AvePoint Docs
Graph API
My support tickets
Graph API
My support tickets
English

    Home > Perform Microsoft Entra ID Migrations > Create a Migration Policy

    Export to PDF

    Create a Migration Policy

    A Microsoft Entra ID migration policy allows you to define how to map the source and destination users and groups in Microsoft Entra ID, configure the conflict resolutions, migration options, and other settings.

    Refer to the following steps to configure a migration policy for Microsoft Entra ID migrations:

    1. Click Policies under Settings in the left pane.

    2. Click Migration policies to access the Migration policies page.

    3. Click the Microsoft Entra ID tab.

    4. Click Create migration policy. The Create migration policy panel appears.

    5. Enter a name and an optional description for the policy, and then click Next.

    6. In the What do you want to migrate? section, select the attributes you want to map for the source and destination objects from the corresponding drop-down list.

      You can click the Add (Add button.) button to add more mappings, or click the Remove (Remove button.) button to remove an added mapping.

      Fly will use the first attribute mapping to map an object. If the object cannot be mapped, Fly will try to map it using the second attribute mapping, and so on.

      *Note: If the source object can be mapped to multiple destination objects based on the attribute mappings configured in the migration policy, the migration of the source object will fail.

    7. In the Conflict resolution section, configure the conflict resolution when the source object conflicts with an existing object in the destination. Refer to the following detailed information on each conflict resolution.

    ResolutionConflictNo Conflict
    SkipIgnore the conflicting object and do nothing in the destination.A new object will be created.
    OverwriteOverwrite the conflicting object attributes in the destination based on the source object attributes.A new object will be created.

    1. Click Next after you finish configuring the conflict resolutions.

    2. In the Additional options & mappings step, you can configure the following settings for migrations.

      • Add membership to the destination Microsoft Entra ID groups – If all users related to the groups to be migrated have already existed in the destination, you can select this checkbox to migrate group membership. If not, we recommend you run a Post-migration > Migrate group membership job to migrate the group membership.

      • Sync user role – Select this checkbox to assign the roles to the destination user/group based on the source user/group's role. This action will not remove any roles already assigned to the destination user/group.

      • *Note: Email notifications will be sent to the Global Administrators after the job is completed.

      • Assign Microsoft licenses to the destination users – Select this checkbox to assign Microsoft licenses to the destination users based on the source user’s license assignments. This action will not remove any licenses already assigned to the destination user.

      • Block sign-in for destination users – Select this checkbox to block sign-in for the destination users created by Fly. These users cannot sign in to Microsoft until they are unblocked. You can unblock user sign-in by running a Post-migration > Unblock user sign-in job.

      • Customized features – This function is unavailable for Microsoft Entra ID migration now.

    3. Click Next to configure Notifications setting.

    4. Select the Send project level notifications (all mappings within a project) checkbox and configure the settings to send migration email notifications to specific recipients after the migration. The migration email notifications are based on the project level, which summarizes the project name and the mapping count of each migration status.

      • Recurrence – Enter a positive integer to define the recurrence days for the notifications.

      • Start date and time – Select a start date and time to send the first notification. The later notifications will be sent at the selected time based on the recurrence.

        If you want to configure the end date and time of the notifications, you can select the Configure end date and time checkbox and select a date and time.

      • Send migration email notifications to – Define the recipients who will receive the notifications.

      • Email template – Create an email template for the notifications by clicking the Add (Button: Add button.) button. Refer to Manage Email Settings for details on how to create an email template. You can also select an existing email template from the drop-down list.

    5. Click Save to save the migration policy.

    On the Migration policies page, you can manage existing policies.

    - Set as default – Select a policy and click **Set as default** to set it as the default policy. The default policy will be automatically selected when you create projects. - Edit – Click the policy name link to edit the policy. - Delete – Select a policy and click **Delete** to delete it. You can also select multiple policies and click **Delete** to delete them. - Copy – This allows you to quickly create a new policy with similar configurations by completing the following steps: 1. Select your target policy, and click **Make a copy**. You can also open your target policy, and click **Make a copy** on the **Edit migration policy** page. 2. Check the settings and make updates if necessary on the **Copy migration policy** page. 3. Click **Save**.