命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
目录设置定义可用于自定义租户范围和特定于对象的限制和允许的行为的配置。 例如，可以阻止组显示名称的单词列表，或定义是否允许来宾成为组所有者。
默认情况下，所有实体都继承预设默认值。 若要更改默认设置，必须使用 directorySettingTemplates 创建新的设置对象。 当在租户范围和特定组定义相同的设置时，实体级设置将替代租户范围的设置。 例如，租户范围的设置可能允许组的现有成员邀请来宾;但单个组设置可以替代且不允许该操作。
组特定的设置仅适用于Microsoft 365 个组。
提示
此 /v1.0 资源的版本名为 groupSetting。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | directorySetting 集合 | 列出所有设置对象的属性。 |
| 创建 | directorySetting | 基于 directorySettingTemplate 创建设置对象。 |
| Get | directorySetting | 读取特定设置对象的属性。 |
| 更新 | directorySetting | 更新 setting 对象。 更新中只能更改 settingValues。 |
| 删除 | 无 | 删除 setting 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| displayName | string | 此组设置的显示名称，来自关联的模板。 只读。 |
| id | string | 这些设置的唯一标识符。 此为只读属性。 |
| templateId | string | 用于创建这组设置的模板的唯一标识符。 只读。 |
| values | settingValue 集合 | 与引用目录 SettingTemplates 对象中的 name 和 defaultValue 属性对应的名称/值对的集合。 |
关系
无
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"displayName": "string",
"id": "string (identifier)",
"templateId": "string",
"values": [{"@odata.type": "microsoft.graph.settingValue"}]
}