Создание группы с назначением роли в Microsoft Entra ID

В этой статье описывается, как создать группу с возможностью назначения ролей с помощью Центра администрирования Microsoft Entra, Microsoft Graph PowerShell или API Microsoft Graph.

С помощью идентификатора Microsoft Entra ID P1 или P2 можно создать группы с возможностью назначения ролей и назначить роли Microsoft Entra этим группам. Вы создаете новую группу, к которой можно назначить роли, установив параметр роли Microsoft Entra могут быть назначены группе в положение Да или задав для свойства isAssignableToRole значение true. Группа, которой могут быть назначены роли, не может быть частью типа динамической группы членства. В Microsoft Entra один клиент может иметь не более 500 групп с возможностью назначения ролей.

Предварительные условия

• Лицензия Microsoft Entra ID P1 или P2
• Администратор привилегированных ролей
• модуль Microsoft Graph PowerShell при использовании PowerShell
• Согласие администратора при использовании обозревателя Graph для API Microsoft Graph.

Дополнительные сведения см. в разделе Предварительные требования для использования PowerShell или Graph Explorer.

Создание группы с возможностью назначения ролей

Центр администрирования

1. Войдите в Центр администрирования Microsoft Entra как минимум администратор привилегированных ролей.

2. Перейдите к Идентификация>Группы>Все группы.

3. Выберите Создать группу.

4. На странице New Group укажите тип группы, имя и описание.

5. Установите для параметра "Роли Microsoft Entra могут быть назначены группе" значение Да.

   Этот параметр отображается администраторам привилегированных ролей, так как эта роль может задать этот параметр.

   

6. Выберите участников и владельцев для группы. Вы также можете назначить роли группе, но на этом шаге назначение роли не требуется.

7. Нажмите кнопку создания.

   Отобразится следующее сообщение:

   Создание группы, к которой могут быть назначены роли Microsoft Entra, является параметром, который нельзя изменить позже. Вы уверены, что хотите добавить эту возможность?

   

8. Выберите Да.

   Группа создается с любыми ролями, которые вы ей назначаете.

PowerShell

Используйте команду New-MgGroup для создания группы, назначаемой ролью.

В этом примере показано, как создать группу, которой может быть назначена роль безопасности.

Connect-MgGraph -Scopes "Group.ReadWrite.All"
$group = New-MgGroup -DisplayName "Contoso_Helpdesk_Administrators" -Description "Helpdesk Administrator role assigned to group" -MailEnabled:$false -SecurityEnabled -MailNickName "contosohelpdeskadministrators" -IsAssignableToRole:$true

В этом примере показано, как создать группу, назначаемую на основе роли в Microsoft 365.

Connect-MgGraph -Scopes "Group.ReadWrite.All"
$group = New-MgGroup -DisplayName "Contoso_Helpdesk_Administrators" -Description "Helpdesk Administrator role assigned to group" -MailEnabled:$true -SecurityEnabled -MailNickName "contosohelpdeskadministrators" -IsAssignableToRole:$true -GroupTypes "Unified"

Graph API

Используйте API создания группы для создания группы, назначаемой ролью.

Этот пример показывает, как создать группу, которой могут быть назначены роли безопасности.

POST https://graph.microsoft.com/v1.0/groups
{
    "description": "Helpdesk Administrator role assigned to group",
    "displayName": "Contoso_Helpdesk_Administrators",
    "isAssignableToRole": true,
    "mailEnabled": false,
    "mailNickname": "contosohelpdeskadministrators",
    "securityEnabled": true
}

Ответ

HTTP/1.1 201 Created

В этом примере показано, как создать группу Microsoft 365, назначаемую на роль.

POST https://graph.microsoft.com/v1.0/groups
{
  "description": "Helpdesk Administrator role assigned to group",
  "displayName": "Contoso_Helpdesk_Administrators",
  "groupTypes": [
    "Unified"
  ],
  "isAssignableToRole": true,
  "mailEnabled": true,
  "mailNickname": "contosohelpdeskadministrators",
  "securityEnabled": true,
  "visibility" : "Private"
}

Для этого типа группы isPublic всегда имеет значение false, и isSecurityEnabled всегда имеет значение true.

Следующие шаги

• Назначить роли Microsoft Entra
• Использование групп Microsoft Entra для управления назначениями ролей
• Устранение неполадок ролей Microsoft Entra, назначенных группам