Microsoft Entra ID
General

Attribute Mapping

In brief

The page’s Microsoft Entra ID-to-AD attribute mapping section was removed and its introductory link now points to the dedicated configuration guide.

What Entra admins need to know

Administrators seeking Microsoft Entra ID-to-AD mapping instructions should use the linked guide; no configuration change is indicated.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

:::image type="content" source="media/how-to-attribute-mapping/new-ux-mapping-1.png" alt-text="Screenshot of new UX screen attribute mapping." lightbox="media/how-to-attribute-mapping/new-ux-mapping-1.png":::

The following document guides you through attribute scoping with Microsoft Entra Cloud Sync for provisioning from Active Directory to Microsoft Entra ID. If you're looking for information on attribute mapping from Microsoft Entra ID to AD, see Attribute mapping - Microsoft Entra ID to Active DirectoryConfigure Microsoft Entra ID to Active Directory provisioning.

You can customize (change, delete, or create) the default attribute mappings according to your business needs. For a list of attributes that are synchronized, see Attributes synchronized to Microsoft Entra ID.

:::image type="content" source="media/how-to-attribute-mapping/new-ux-mapping-6.png" alt-text="Screenshot of successful schema save." lightbox="media/how-to-attribute-mapping/new-ux-mapping-6.png":::

Add an attribute mapping - Microsoft Entra ID to Active Directory

Use the following steps for configuring attribute mapping with a Microsoft Entra ID to Active Directory configuration.

[!INCLUDE sign in] 3. Under Configuration, select your Microsoft Entra ID to Active Directory configuration. 4. On the left, select Attribute mapping. 5. At the top, ensure that you have the correct object type selected. That is, user, group, or contact. 6. Click Add attribute mapping.

:::image type="content" source="media/how-to-attribute-mapping/entra-to-ad-1.png" alt-text="Screenshot of adding an attribute mapping for Microsoft Entra ID to Active Directory." lightbox="media/how-to-attribute-mapping/entra-to-ad-1.png":::

  1. Select the mapping type. The mapping type can be one of the following:

    • Direct: The target attribute is populated with the value of an attribute of the linked object in Active Directory.
    • Constant: The target attribute is populated with a specific string that you specify.
    • Expression: The target attribute is populated based on the result of a script-like expression.
    • None: The target attribute is left unmodified.
  2. Depending on what you have selected in the previous step, different options are available for filling in.

  3. Select when to apply this mapping, and then select Apply.

  4. Back on the Attribute mappings screen, you should see your new attribute mapping.

  5. Select Save schema. You'll be notified that once you save the schema, a synchronization occurs. Click OK.

  6. Once the save is successful you'll see a notification on the right.

Test your attribute mapping

To test your attribute mapping, you can use on-demand provisioning:

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…