Dynamic membership for administrative units
Microsoft's edit ·
Microsoft's commit message in MicrosoftDocs/entra-docs · commit 44977a7 · +15 −9 lines · also on GitHub
⋯ 39 unchanged lines
4040
4141
Follow these steps to create administrative units with rules for dynamic membership groups for users or devices.
4242
43
−### Microsoft Entra admin center
43
+# [Admin center](#tab/admin-center)
4444
4545
[!INCLUDE [portal updates](~/includes/portal-update.md)]
4646
⋯ 25 unchanged lines
7272
7373
For steps on how to edit your rule, see the following [Edit rules for dynamic membership groups](#edit-rules-for-dynamic-membership-groups) section.
7474
75
−### PowerShell
75
+# [PowerShell](#tab/ms-powershell)
7676
7777
1. Create a dynamic membership groups rule. For more information, see [Manage rules for dynamic membership groups in Microsoft Entra ID](~/identity/users/groups-dynamic-membership.md).
7878
⋯ 22 unchanged lines
101101
New-MgDirectoryAdministrativeUnit -BodyParameter $params
102102
```
103103
104
−### Microsoft Graph API
104
+# [Graph API](#tab/ms-graph)
105105
106106
1. Create a rule for dynamic membership groups. For more information, see [Dynamic membership rules for groups in Microsoft Entra ID](~/identity/users/groups-dynamic-membership.md).
107107
⋯ 19 unchanged lines
127127
}
128128
```
129129
130
+---
131
+
130132
## Edit rules for dynamic membership groups
131133
132134
When an administrative unit has been configured for dynamic membership groups, the usual commands to add or remove members for the administrative unit are disabled as the dynamic membership groups engine retains the sole ownership of adding or removing members. To make changes to the membership, you can edit the rules for dynamic membership groups.
133135
134
−### Microsoft Entra admin center
136
+# [Admin center](#tab/admin-center)
135137
136138
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Privileged Role Administrator](~/identity/role-based-access-control/permissions-reference.md#privileged-role-administrator).
137139
⋯ 9 unchanged lines
147149
148150
1. When finished, select **Save** to save the dynamic membership groups rule changes.
149151
150
−### PowerShell
152
+# [PowerShell](#tab/ms-powershell)
151153
152154
Use the [Update-MgDirectoryAdministrativeUnit](/powershell/module/microsoft.graph.identity.directorymanagement/update-mgdirectoryadministrativeunit) command to edit the dynamic membership groups rule.
153155
⋯ 7 unchanged lines
161163
Update-MgDirectoryAdministrativeUnit -AdministrativeUnitId $adminUnit.Id -BodyParameter $params
162164
```
163165
164
−### Microsoft Graph API
166
+# [Graph API](#tab/ms-graph)
165167
166168
Use the [Update administrativeUnit](/graph/api/administrativeunit-update) API to edit the rule for dynamic membership groups.
167169
⋯ 11 unchanged lines
179181
}
180182
```
181183
184
+---
185
+
182186
## Change a dynamic administrative unit to assigned
183187
184188
Follow these steps to change an administrative unit with rules for dynamic membership groups to an administrative unit where members are manually assigned.
185189
186
−### Microsoft Entra admin center
190
+# [Admin center](#tab/admin-center)
187191
188192
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Privileged Role Administrator](~/identity/role-based-access-control/permissions-reference.md#privileged-role-administrator).
189193
⋯ 17 unchanged lines
207211
208212
When the membership type setting is changed from dynamic to assigned, the current members remain intact in the administrative unit. Additionally, the ability to add groups to the administrative unit is enabled.
209213
210
−### PowerShell
214
+# [PowerShell](#tab/ms-powershell)
211215
212216
Use the [Update-MgDirectoryAdministrativeUnit](/powershell/module/microsoft.graph.identity.directorymanagement/update-mgdirectoryadministrativeunit) command to edit the rule for dynamic membership groups.
213217
⋯ 8 unchanged lines
222226
Update-MgDirectoryAdministrativeUnit -AdministrativeUnitId $adminUnit.Id -BodyParameter $params
223227
```
224228
225
−### Microsoft Graph API
229
+# [Graph API](#tab/ms-graph)
226230
227231
Use the [Update administrativeUnit](/graph/api/administrativeunit-update) API to change the membership type setting.
228232
⋯ 10 unchanged lines
239243
"membershipType": "Assigned"
240244
}
241245
```
246
+
247
+---
242248
243249
## Next steps
244250
⋯ 3 unchanged lines
Microsoft's Markdown source from MicrosoftDocs/entra-docs, © Microsoft Corporation, under MIT. Changed lines with up to 3 unchanged lines around each; ChangeIntel kept this copy 26 Oct 06:37 UTC. The commit date is when the source changed, which can be hours or days before Learn published it.