directorySetting 资源类型directorySetting resource type


Microsoft Graph 中/beta的版本下的 api 可能会发生更改。APIs under the /beta version in Microsoft Graph are subject to change. 不支持在生产应用程序中使用这些 API。Use of these APIs in production applications is not supported.

可以基于可用的directorySettingTemplates创建目录设置, 并将其更改为预设的默认值。Directory settings can be created based on the available directorySettingTemplates, and changed from their preset defaults. 这些设置可以控制实体或功能行为, 既可以在租户范围级别, 也可以在特定实体级别进行。These settings can govern entity or feature behaviors, both at a tenant-wide level or at a specific entity level. 如果在租户范围和特定实体级别定义相同的设置, 则特定实体级别设置可能会从租户范围设置中退出。When the same setting is defined at both the tenant-wide and specific entity level, the specific entity level setting may opt-out from the tenant-wide setting. 例如, 租户范围内的设置可能会允许来宾受到现有组成员的邀请, 但特定的组设置可能会退出, 而不允许由组成员邀请来宾。For example, the tenant-wide setting may allow guests to be invited by existing members of groups, but a specific group setting may opt-out and not allow guests to be invited by members of the group. 当前的系统定义的设置仅控制 Office 组的行为。Currently system defined settings are only govern Office groups behavior.

注意: directorySetting 资源类型的/beta 版本仅适用于组。Note: The /beta version of the directorySetting resource type only applies to groups. /V1.0 版本已重命名为 groupSetting。The /v1.0 version has been renamed to groupSetting.


方法Method 返回类型Return Type 说明Description
Create settingCreate setting directorySettingdirectorySetting 创建基于 directorySettingTemplate 的 setting 对象。Create a setting object based on a directorySettingTemplate. POST 请求必须为模板中定义的所有设置提供 settingValues。The POST request must provide settingValues for all the settings defined in the template.
Get settingGet setting directorySettingdirectorySetting 读取特定设置对象的属性。Read properties of a specific setting object.
List settingsList settings directorySetting 集合directorySetting collection 列出所有设置对象的属性。List properties of all setting objects.
Update settingUpdate setting directorySettingdirectorySetting 更新 setting 对象。Update a setting object. 仅在更新中可以更改 settingValues。Only settingValues can be changed in an update.
删除设置Delete setting None 删除 setting 对象。Delete a setting object.


属性Property 类型Type 说明Description
displayNamedisplayName stringstring 来自关联模板的此组设置的显示名称。Display name of this group of settings, which comes from the associated template. 只读。Read-only.
idid stringstring 这些设置的唯一标识符。Unique identifier for these settings. 只读。Read-only.
templateIdtemplateId stringstring 用于创建此组设置的模板的唯一标识符。Unique identifier for the template used to create this group of settings. 只读。Read-only.
valuesvalues settingValue集合settingValue collection 名称值对的集合。Collection of name value pairs. 必须包含并设置在模板中定义的所有设置。Must contain and set all the settings defined in the template.



JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。Here is a JSON representation of the resource.

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