тип ресурса directoryНастройка

Статья
03/26/2023

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Параметры каталога определяют конфигурации, которые можно использовать для настройки ограничений и разрешенного поведения для всего клиента и объектов. Например, можно заблокировать списки слов для отображаемых имен групп или определить, разрешено ли гостевым пользователям быть владельцами групп.

По умолчанию все сущности наследуют предустановленные значения по умолчанию. Чтобы изменить параметры по умолчанию, необходимо создать новый объект settings с помощью каталогаSettingTemplates. Если один и тот же параметр определен как на уровне клиента, так и для определенной группы, параметр на уровне сущности переопределяет параметр на уровне клиента. Например, параметр на уровне клиента может разрешить приглашать гостей существующими участниками групп, но отдельный параметр группы может переопределить и запретить приглашение гостей участниками группы.

Совет

Версия /v1.0 этого ресурса называется groupSetting.

Методы

Метод	Возвращаемый тип	Описание
Создание параметра	directorySetting	Создайте объект параметра на основе каталогаSettingTemplate.
Получение параметра	directorySetting	Считывание свойств определенного объекта setting.
Перечисление параметров	Коллекция directorySetting	Перечисление свойств всех объектов setting.
Обновление параметра	directorySetting	Обновление объекта setting. В обновлении можно изменить только settingValues.
Удаление параметра	Нет	Удаление объекта setting.

Свойства

Свойство	Тип	Описание
displayName	string	Отображаемое имя этой группы параметров, которое поступает из связанного шаблона. Только для чтения.
id	string	Уникальный идентификатор для этих параметров. Только для чтения.
templateId	string	Уникальный идентификатор шаблона, используемого для создания этой группы параметров. Только для чтения.
values	коллекция settingValue	Коллекция пар "имя-значение", соответствующих свойствам name и defaultValue в объекте directorySettingTemplates .

Связи

Нет

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "displayName": "string",
  "id": "string (identifier)",
  "templateId": "string",
  "values": [{"@odata.type": "microsoft.graph.settingValue"}]
}