You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/active-directory/hybrid/how-to-connect-group-writeback-v2.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,7 +41,7 @@ The following document will walk you through what you need to know before you en
41
41
42
42
43
43
## Plan Your Implementation
44
-
There are a few activities that you will want to complete before enabling the latest public preview of group writeback. These activities include discovering your current configuration, verifying the pre-requisites, and choosing the deployment approach.
44
+
There are a few activities that you'll want to complete before enabling the latest public preview of group writeback. These activities include discovering your current configuration, verifying the pre-requisites, and choosing the deployment approach.
45
45
46
46
## Discovery
47
47
The following sections describe various methods of discovery and how you can discover if group writeback in enabled.
@@ -69,23 +69,23 @@ You can also view the writeback state via MS Graph: [Get group](https://docs.mic
- If isEnabled is null or true, the group will be written back.
72
-
- If isEnabled is false, the group will not be written back.
72
+
- If isEnabled is false, the group won't be written back.
73
73
74
74
Finally, you can also view the writeback state via PowerShell using the [Microsoft Identity Tools PowerShell Module](https://www.powershellgallery.com/packages/MSIdentityTools/2.0.16)
### Discover the default writeback setting for newly created Microsoft 365 groups
79
79
80
-
For groups that have not been created yet, you can view whether or not they are going to be automatically written back.
80
+
For groups that haven't been created yet, you can view whether or not they're going to be automatically written back.
81
81
82
82
To see the default behavior in your environment for newly created groups use MS Graph: [directorySetting](https://docs.microsoft.com/graph/api/resources/directorysetting?view=graph-rest-beta)
If a `directorySetting` named **Group.Unified**does not exist, the default directory setting is applied and newly created Microsoft 365 groups **will automatically** be written back.
86
+
If a `directorySetting` named **Group.Unified**doesn't exist, the default directory setting is applied and newly created Microsoft 365 groups **will automatically** be written back.
87
87
88
-
If a `directorySetting` named **Group.Unified** exists with a `NewUnifiedGroupWritebackDefault` value of **false**, Microsoft 365 groups **will not automatically** be enabled for write back when they are created. If the value is not specified or it is set to true, newly created Microsoft 365 groups **will automatically** be written back.
88
+
If a `directorySetting` named **Group.Unified** exists with a `NewUnifiedGroupWritebackDefault` value of **false**, Microsoft 365 groups **won't automatically** be enabled for write back when they're created. If the value is not specified or it is set to true, newly created Microsoft 365 groups **will automatically** be written back.
89
89
90
90
91
91
You can also use the PowerShell cmdlet [AzureADDirectorySetting](https://docs.microsoft.com/azure/active-directory/enterprise-users/groups-settings-cmdlets)
@@ -94,7 +94,7 @@ You can also use the PowerShell cmdlet [AzureADDirectorySetting](https://docs.mi
94
94
95
95
If nothing is returned, you are using the default directory settings, and newly created Microsoft 365 groups **will automatically** be written back.
96
96
97
-
If a `directorySetting` is returned with a `NewUnifiedGroupWritebackDefault` value of **false**, Microsoft 365 groups **will not automatically** be enabled for write back when they are created. If the value is not specified or it is set to **true**, newly created Microsoft 365 groups **will automatically** be written back.
97
+
If a `directorySetting` is returned with a `NewUnifiedGroupWritebackDefault` value of **false**, Microsoft 365 groups **won't automatically** be enabled for write back when they're created. If the value is not specified or it is set to **true**, newly created Microsoft 365 groups **will automatically** be written back.
98
98
99
99
### Discover if AD has been prepared for Exchange
100
100
To verify if Active Directory has been prepared for Exchange, see [Prepare Active Directory and domains for Exchange Server, Active Directory Exchange Server, Exchange Server Active Directory, Exchange 2019 Active Directory](https://docs.microsoft.com/Exchange/plan-and-deploy/prepare-ad-and-domains?view=exchserver-2019#how-do-you-know-this-worked)
@@ -107,22 +107,22 @@ The following are pre-requistes for group writeback.
107
107
-**Optional**: Exchange Server 2016 CU15 or later
108
108
- Only needed for configuring cloud groups with Exchange Hybrid.
109
109
- See [Configure Microsoft 365 Groups with on-premises Exchange hybrid](https://docs.microsoft.com/exchange/hybrid-deployment/set-up-microsoft-365-groups#prerequisites) for more information.
110
-
- If you have not [prepared AD for Exchange](https://docs.microsoft.com/Exchange/plan-and-deploy/prepare-ad-and-domains?view=exchserver-2019), mail related attributes of groups will not be written back.
110
+
- If you haven't [prepared AD for Exchange](https://docs.microsoft.com/Exchange/plan-and-deploy/prepare-ad-and-domains?view=exchserver-2019), mail related attributes of groups won't be written back.
111
111
112
112
## Choosing the right approach
113
113
Choosing the right deployment approach for your organization will depend on the current state of group writeback in your environment and the desired writeback behavior.
114
114
115
115
When enabling group writeback, the following default behavior will be experienced:
116
116
117
117
- All existing Microsoft 365 groups will automatically be written back to Active Directory, including all future Microsoft 365 groups created. Azure AD Security groups are not automatically written back, they must each be enabled for writeback.
118
-
- Groups that have been written back will not be deleted in AD, if they are disabled for writeback or soft deleted. They will remain in AD until they are hard deleted in Azure AD. Changes made to these groups in Azure AD will not be written back, until the groups are re-enabled for writeback or restored from soft delete state. This requirement protects the AD groups from accidental deletion, should they be unintentionally disabled for writeback or soft deleted in Azure AD.
118
+
- Groups that have been written back won't be deleted in AD, if they're disabled for writeback or soft deleted. They will remain in AD until they're hard deleted in Azure AD. Changes made to these groups in Azure AD won't be written back, until the groups are re-enabled for writeback or restored from soft delete state. This requirement protects the AD groups from accidental deletion, should they be unintentionally disabled for writeback or soft deleted in Azure AD.
119
119
- Microsoft 365 groups with over 50,000 members and Azure AD security groups with over 250,000 cannot be written back to on-premises.
120
120
To keep the default behavior, continue to the [enable group writeback](how-to-connect-group-writeback-enable.md) article.
121
121
122
122
The default behavior can be modified as follows:
123
123
124
124
- Only groups that are configured for write back will be written back, including newly created Microsoft 365 groups.
125
-
- Groups that are written to on prem will be deleted in AD when they are either disabled for group writeback, soft deleted, or hard deleted in Azure AD.
125
+
- Groups that are written to on prem will be deleted in AD when they're either disabled for group writeback, soft deleted, or hard deleted in Azure AD.
126
126
- Microsoft 365 groups with up to 250,000 members can be written back to on-premises.
127
127
128
128
If you plan to make changes to the default behavior, we recommend that you do so prior to enabling group writeback. However, you can still modify the default behavior, if group writeback is already enabled. To modify the default behavior, see [Modifying group writeback](how-to-connect-modify-group-writeback.md).
@@ -134,8 +134,8 @@ While this release has undergone extensive testing, you may still encounter issu
134
134
135
135
- Cloud [distribution list groups](https://docs.microsoft.com/exchange/recipients-in-exchange-online/manage-distribution-groups/manage-distribution-groups) created in Exchange Online cannot be written back to AD, only Microsoft 365 and Azure AD security groups are supported.
136
136
- To be backwards compatible with the current version of group writeback, when you enable group writeback, all existing Microsoft 365 groups are written back and created as distribution groups, by default. This behavior can be modified by following the steps detailed in the [modify default behavior](link article 2) article.
137
-
- When you disable writeback for a group, the group will not automatically be removed from your on-premises Active Directory, until hard deleted in Azure AD. This behavior can be modified by following the steps detailed in the [modify default behavior](link article 2) article.
138
-
- Group Writeback does not support writeback of nested group members that have a scope of ‘Domain local’ in AD, since Azure AD security groups are written back with scope ‘Universal’. If you have a nested group like this, you will see an export error in Azure AD Connect with the message “A universal group cannot have a local group as a member.” The resolution is to remove the member with scope ‘Domain local’ from the Azure AD group or update the nested group member scope in AD to ‘Global’ or ‘Universal’ group.
137
+
- When you disable writeback for a group, the group won't automatically be removed from your on-premises Active Directory, until hard deleted in Azure AD. This behavior can be modified by following the steps detailed in the [modify default behavior](link article 2) article.
138
+
- Group Writeback does not support writeback of nested group members that have a scope of ‘Domain local’ in AD, since Azure AD security groups are written back with scope ‘Universal’. If you have a nested group like this, you'll see an export error in Azure AD Connect with the message “A universal group cannot have a local group as a member.” The resolution is to remove the member with scope ‘Domain local’ from the Azure AD group or update the nested group member scope in AD to ‘Global’ or ‘Universal’ group.
139
139
- Group Writeback only supports writing back groups to a single Organization Unit (OU). Once the feature is enabled, you cannot change the OU you selected. A workaround is to disable group writeback entirely in Azure AD Connect and then select a different OU when you re-enable the feature.
140
140
- Nested cloud groups that are members of writeback enabled groups must also be enabled for writeback to remain nested in AD.
141
141
- Group Writeback setting to manage new security group writeback at scale is not yet available. You will need to configure writeback for each group.
Group writeback is the feature that allows you to write cloud groups back to your on-premises Active Directory using Azure AD Connect Sync. You can change the default behavior in the following ways:
22
22
23
23
- Only groups that are configured for write back will be written back, including newly created Microsoft 365 groups.
24
-
- Groups that are written back will be deleted in AD when they are either disabled for group writeback, soft deleted, or hard deleted in Azure AD.
24
+
- Groups that are written back will be deleted in AD when they're either disabled for group writeback, soft deleted, or hard deleted in Azure AD.
25
25
- Microsoft 365 groups with up to 250,000 members can be written back to on-premises.
26
26
27
27
The following document will walk you through deploying the options for modifying the default behaviors of Azure AD Connect group writeback.
28
28
29
29
## Considerations for Existing Deployments
30
30
31
-
If the original version of group writeback is already enabled and in use in your environment, then all your Microsoft 365 groups have already been written back to AD. Instead of disabling all Microsoft 365 groups, you will want to review any use of the previously written back groups, and disable only those that are no longer needed in on-prem AD.
31
+
If the original version of group writeback is already enabled and in use in your environment, then all your Microsoft 365 groups have already been written back to AD. Instead of disabling all Microsoft 365 groups, you'll want to review any use of the previously written back groups, and disable only those that are no longer needed in on-prem AD.
32
32
33
33
### Disable automatic writeback of all Microsoft 365 groups
34
34
@@ -56,14 +56,14 @@ If the original version of group writeback is already enabled and in use in your
56
56
## Delete groups when disabled for writeback or soft deleted
57
57
58
58
>[!Note]
59
-
>After deletion in AD, written back groups are not automatically restored from the AD recycle bin, if they are re-enabled for writeback or restored from soft delete state. New groups will be created. Deleted groups restored from the AD recycle bin, prior to being re-enabled for writeback or restored from soft delete state in Azure AD, will be joined to their respective Azure AD group.
59
+
>After deletion in AD, written back groups are not automatically restored from the AD recycle bin, if they're re-enabled for writeback or restored from soft delete state. New groups will be created. Deleted groups restored from the AD recycle bin, prior to being re-enabled for writeback or restored from soft delete state in Azure AD, will be joined to their respective Azure AD group.
60
60
61
61
1. On your Azure AD Connect server, open a PowerShell prompt as administrator.
62
62
2. Disable [Azure AD Connect sync scheduler](https://docs.microsoft.com/azure/active-directory/hybrid/how-to-connect-sync-feature-scheduler)
63
63
``` PowerShell
64
64
Set-ADSyncScheduler -SyncCycleEnabled $false
65
65
```
66
-
3. Create a custom synchronization rule in Azure AD Connect to delete written back groups when they are disabled for writeback or soft deleted
66
+
3. Create a custom synchronization rule in Azure AD Connect to delete written back groups when they're disabled for writeback or soft deleted
67
67
```PowerShell
68
68
import-module ADSync
69
69
$precedenceValue = Read-Host -Prompt "Enter a unique sync rule precedence value [0-99]"
@@ -152,7 +152,7 @@ Since the default sync rule, that limits the group size, is created when group w
152
152
153
153
## Restoring from AD Recycle Bin
154
154
155
-
If you are updating the default behavior to delete groups when disabled for writeback or soft deleted, we recommend that you enable the [Active Directory Recycle Bin](https://docs.microsoft.com/azure/active-directory/hybrid/how-to-connect-sync-recycle-bin) feature for your on-premises instances of Active Directory. This feature will allow you to manually restore previously deleted AD groups, so that they can be rejoined to their respective Azure AD groups, if they were accidentally disabled for writeback or soft deleted.
155
+
If you're updating the default behavior to delete groups when disabled for writeback or soft deleted, we recommend that you enable the [Active Directory Recycle Bin](https://docs.microsoft.com/azure/active-directory/hybrid/how-to-connect-sync-recycle-bin) feature for your on-premises instances of Active Directory. This feature will allow you to manually restore previously deleted AD groups, so that they can be rejoined to their respective Azure AD groups, if they were accidentally disabled for writeback or soft deleted.
156
156
157
157
Prior to re-enabling for writeback, or restoring from soft delete in Azure AD, the group will first need to be restored in AD.
0 commit comments