Microsoft Entra ID

Migrate Group Writeback

In brief

- Cloud-created [security groups](../../../fundamentals/concept-learn-about-groups.md#group-types).

What Entra admins need to know

Review the documentation change to determine whether it affects tenant configuration, security posture, or rollout plans.

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

Documentation change

Open on Microsoft Learn ↗

The comparison below is an extract of the Microsoft Learn article showing only the changed content. Open the full article for complete context.

Mail-enabled groups and distribution lists written back to Active Directory continue to work with Microsoft Entra Connect Group Writeback but revert to the behavior of Group Writeback v1. In this scenario, after you disable Group Writeback v2, all Microsoft 365 groups are written back to Active Directory independently of the Writeback Enabled setting in the Microsoft Entra admin center. For more information, see Provision to Active Directory with Microsoft Entra Cloud Sync FAQ

Mail-enabled groups and distribution lists written back to Active Directory continue to work with Microsoft Entra Connect Group Writeback but revert to the behavior of Group Writeback v1. In this scenario, after you disable Group Writeback v2, all Microsoft 365 groups are written back to Active Directory independently of the Writeback Enabled setting in the Microsoft Entra admin center. For more information, see Provision to Active Directory with Microsoft Entra Cloud Sync FAQ.

Prerequisites

Step 3: Create a custom group inbound rule

In the Microsoft Entra Connect Synchronization Rules Editor, create an inbound sync rule that targets cloud-created groups that are currently mastered in Microsoft Entra ID and have a NULL mail attribute. This inbound sync rule is a join rule that sets the cloudNoFlow attribute to True.True.

The purpose of this rule is to flag these groups so that Microsoft Entra Connect Sync continues to recognize them as joined objects after Group Writeback is disabled, preventing themdisabled. This prevents the existing on-premises group objects from being treated as out-of-out of scope objects. This rule is required to preserve existing on-premises group objects during the transition from Group Writeback in Microsoft Entra Connect Sync to group provisioning usingin Microsoft Entra Cloud Sync.

You can create this sync rule by using either the user interface or PowerShell with the provided script.

Create a custom group inbound rule in the user interface

Step 4: Create a custom group outbound rule

You also need an outbound sync rule with a Link Typelink type of JoinNoFlow and a scoping filter that selects groups where cloudNoFlow is set to True. This outbound rule ensures that,maintains the join relationship after Group Writeback is disabled in Microsoft Entra Connect, it maintains the join relationship without flowing changes or triggering deprovisioning.Connect Sync, and prevents object adds, object deletes, and non-reference attribute updates from being exported for those groups.

Without this rule, previously written-back groups wouldmight be interpreted as no longer in scope and deleted from on-premises Active Directory during the next sync cycle. This rule is required to safely retire Group Writeback v2 while allowing Microsoft Entra Cloud Sync to take over group provisioning responsibilities.

You can create this sync rule by using either the user interface or PowerShell with the provided script.

Create a custom group outbound rule in the user interface

Step 7: Configure Microsoft Entra Cloud Sync

Now that the groups are removed from the synchronization scope of Microsoft Entra Connect Sync, you canSync has the no-flow rules configured for the existing written-back groups, set up and configure Microsoft Entra Cloud Sync to take over synchronizationprovisioning of the security groups.groups to Active Directory. For more information, see Provision groups to Active Directory by using Microsoft Entra Cloud Sync.

Before you decommission Microsoft Entra Connect Sync Group Writeback, verify that Microsoft Entra Cloud Sync provisions the groups and maintains their memberships in Active Directory.

Related content