directorySettingTemplate 资源类型directorySettingTemplate 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.

目录设置模板表示可供租户使用的系统定义设置。Directory setting templates represent system-defined settings available to the tenant. 可以基于可用的 directorySettingTemplates 创建目录设置, 并将值更改为其预设默认值。Directory settings can be created based on the available directorySettingTemplates, and values changed from their preset defaults. 无法创建、更新或删除目录设置模板。Directory setting templates cannot be created, updated or deleted. 这些设置可以表示租户范围的设置, 也可以表示特定的实体设置。These settings can represent tenant-wide settings, or can represent specific entity settings. 目前, 仅有的可用模板适用于 Office 组, 并包含诸如用户是否可以创建组或邀请来自组织外部的来宾以成为组成员的设置。Currently, the only templates available apply to Office groups, and include settings such as whether users can create groups or invite guests from outside the organization to become members of a group.

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


方法Method 返回类型Return Type 说明Description
获取 directorySettingTemplateGet directorySettingTemplate directorySettingTemplatedirectorySettingTemplate 读取某个系统定义的 directorySettingTemplate 对象的特定属性。Read the specific properties of one of the system defined directorySettingTemplate objects.
列出 directorySettingTemplateList directorySettingTemplate DirectorySettingTemplate 的集合Collection of directorySettingTemplate 列出所有系统定义的 directorySettingTemplate 对象。List all of the system defined directorySettingTemplate objects.


属性Property 类型Type 说明Description
说明description stringstring 模板的说明。Description of the template. 只读。Read-only.
displayNamedisplayName stringstring 模板的显示名称。Display name of the template. 只读。Read-only.
idid 字符串string 模板的唯一标识符。Unique identifier for the template. 只读。Read-only.
valuesvalues settingTemplateValue集合settingTemplateValue collection Settemplatevalues 的集合, 该集合列出了组成此模板的可用设置、默认值和类型的集合。Collection of settingTemplateValues that list the set of available settings, defaults and types that make up this template. 只读。Read-only.



JSON 表示形式JSON representation

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

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