Create a role-assignable group in Azure Active Directory
With Azure AD Premium P1 or P2, you can create role-assignable groups and assign Azure AD roles to these groups. You create a new role-assignable group by setting Azure AD roles can be assigned to the group to Yes or by setting the isAssignableToRole property set to true. A role-assignable group can't be of dynamic membership type and you can create a maximum of 500 groups in a single tenant.
This article describes how to create a role-assignable group using the Azure portal, PowerShell, or Microsoft Graph API.
Prerequisites
- Azure AD Premium P1 or P2 license
- Privileged Role Administrator
- Microsoft.Graph module when using Microsoft Graph PowerShell
- AzureAD module when using Azure AD PowerShell
- Admin consent when using Graph explorer for Microsoft Graph API
For more information, see Prerequisites to use PowerShell or Graph Explorer.
Azure portal
Sign in to the Azure portal.
Select Azure Active Directory > Groups > All groups > New group.
On the New Group tab, provide group type, name and description.
Set Azure AD roles can be assigned to the group to Yes.
This option is visible to only Privileged Role Administrators and Global Administrators because these are only two roles that can set this option.
Select the members and owners for the group. You also have the option to assign roles to the group, but assigning a role isn't required here.
Select Create.
You see the following message:
Creating a group to which Azure AD roles can be assigned is a setting that cannot be changed later. Are you sure you want to add this capability?
Select Yes.
The group is created with any roles you might have assigned to it.
PowerShell
Use the New-MgGroup command to create a role-assignable group.
Connect-MgGraph -Scopes "Group.ReadWrite.All"
$group = New-MgGroup -DisplayName "Contoso_Helpdesk_Administrators" -Description "This group has Helpdesk Administrator built-in role assigned to it in Azure AD." -MailEnabled:$false -SecurityEnabled -MailNickName "contosohelpdeskadministrators" -IsAssignableToRole:$true
Microsoft Graph API
Use the Create group API to create a role-assignable group.
POST https://graph.microsoft.com/v1.0/groups
{
"description": "This group is assigned to Helpdesk Administrator built-in role of Azure AD.",
"displayName": "Contoso_Helpdesk_Administrators",
"groupTypes": [
"Unified"
],
"isAssignableToRole": true,
"mailEnabled": true,
"securityEnabled": true,
"mailNickname": "contosohelpdeskadministrators",
"visibility" : "Private"
}
For this type of group, isPublic will always be false and isSecurityEnabled will always be true.
Next steps
Feedback
Submit and view feedback for