Создание параметров

Пространство имен: microsoft.graph

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

Параметры групп применяются только к группам Microsoft 365. Шаблон с именем Group.Unified можно использовать для настройки параметров группы Microsoft 365 на уровне клиента, а шаблон с именем Group.Unified.Guest — для настройки параметров группы.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Directory.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Directory.ReadWrite.All Недоступно.

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие роли с наименьшими привилегиями.

  • Чтение основных свойств параметров шаблонов и параметров — локальный администратор устройства Microsoft Entra присоединение, читатели каталогов, глобальное средство чтения
  • Управление всеми параметрами группы или каталога — записи каталогов
  • Управление глобальными и локальными параметрами для групп; управление Group.Unified.Guest и Group.Unified параметры — администратор Группы
  • Обновление Password Rule Settings — администратор политики проверки подлинности
  • Обновление параметров, чтение основных свойств для шаблонов и параметров — администратор пользователей

HTTP-запрос

Создайте параметр на уровне клиента.

POST /groupSettings

Создайте параметр для группы.

POST /groups/{id}/settings

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json

Текст запроса

В теле запроса предоставьте описание объекта groupSetting в формате JSON. Отображаемое имя, templateId и описание наследуются от объекта groupSettingTemplates , на который ссылается ссылка. Только свойство value может быть изменено со значения по умолчанию.

При создании объекта groupSetting требуются следующие свойства.

Параметр Тип Описание
templateId String Уникальный идентификатор объекта group уровня клиентаSettingTemplates , используемого для создания этого объекта параметров уровня группы. Только для чтения.
values коллекция settingValue Коллекция пар "имя-значение", соответствующих свойствам name и defaultValue в объекте groupSettingTemplates , на который ссылается ссылка.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект groupSetting в теле отклика.

Пример 1. Создание нового параметра для всех групп Microsoft 365 в клиенте

Запрос

Только объект groupSettingTemplates с именем Group.Unified может применяться ко всем группам Microsoft 365 на уровне клиента.

POST https://graph.microsoft.com/v1.0/groupSettings
Content-type: application/json

{
    "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
    "values": [
        {
            "name": "GuestUsageGuidelinesUrl",
            "value": "https://privacy.contoso.com/privacystatement"
        },
        {
            "name": "EnableMSStandardBlockedWords",
            "value": "true"
        },
        {
            "name": "EnableMIPLabels",
            "value": "true"
        },
        {
            "name": "PrefixSuffixNamingRequirement",
            "value": "[Contoso-][GroupName]"
        }
    ]
}

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings/$entity",
    "id": "844d252c-4de2-43eb-a784-96df77231aae",
    "displayName": null,
    "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
    "values": [
        {
            "name": "GuestUsageGuidelinesUrl",
            "value": "https://privacy.contoso.com/privacystatement"
        },
        {
            "name": "EnableMSStandardBlockedWords",
            "value": "true"
        },
        {
            "name": "EnableMIPLabels",
            "value": "true"
        },
        {
            "name": "PrefixSuffixNamingRequirement",
            "value": "[Contoso-][GroupName]"
        }
    ]
}

Свойство displayName и другие пары "имя-значение" будут заполнены значениями по умолчанию из объекта groupSettingTemplates , соответствующего templateId.

Пример 2. Создание параметра для блокировки гостей для определенной группы Microsoft 365

Запрос

Только объект groupSettingTemplates с именем Group.Unified.Guest можно применить к определенным группам Microsoft 365.

POST https://graph.microsoft.com/v1.0/groups/055a5d18-a3a9-4338-b9c5-de92559b7ebf/settings
Content-type: application/json

{
    "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
    "values": [
        {
            "name": "AllowToAddGuests",
            "value": "false"
        }
    ]
}

В теле запроса предоставьте описание объекта groupSetting в формате JSON.

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings/$entity",
    "id": "a06fa228-3042-4662-bd09-33e298da1afe",
    "displayName": null,
    "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
    "values": [
        {
            "name": "AllowToAddGuests",
            "value": "false"
        }
    ]
}