Создание группы с назначением роли в 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.

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

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

Совет

Действия, описанные в этой статье, могут немного отличаться на портале, с который вы начинаете работу.

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, назначенных группам