directorySetting 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

目录设置定义可用于自定义租户范围内和特定于对象的限制和允许的行为的配置。例如，可以阻止组显示名称的单词列表，或定义是否允许来宾用户成为组所有者。

默认情况下，所有实体继承预设默认值。若要更改默认设置，必须使用 directorySettingTemplates 创建新的设置对象。当在租户范围和特定组上定义相同设置时，实体级别设置将覆盖租户范围的设置。例如，租户范围设置可能允许现有组成员邀请来宾，但单个组设置可以覆盖并不允许组的成员邀请来宾。

提示

此 /v1.0 资源的版本名为 groupSetting。

方法

方法	返回类型	说明
Create setting	directorySetting	创建基于 directorySettingTemplate 的设置对象。
Get setting	directorySetting	读取特定设置对象的属性。
List settings	directorySetting 集合	列出所有设置对象的属性。
Update setting	directorySetting	更新 setting 对象。更新中只能更改 settingValues。
删除设置	无	删除 setting 对象。

属性	类型	说明
displayName	string	这组设置的显示名称，来自关联的模板。只读。
id	string	这些设置的唯一标识符。只读。
templateId	字符串	用于创建该组设置的模板的唯一标识符。只读。
values	settingValue 集合	与引用的 directorySettingTemplates 对象中的 name 和 defaultValue 属性对应的名称-值对的集合。

无

下面是资源的 JSON 表示形式。

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