directoryRoleTemplate 资源类型

命名空间：microsoft.graph

重要

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

表示目录角色模板。 目录角色模板指定目录角色的属性值 (directoryRole) 。 对于可在租户中激活的每个目录角色，都有关联的目录角色模板对象。 要读取目录角色或更新其成员，首先必须在租户中将其激活。 默认情况下，仅激活公司管理员目录角色。 若要激活其他可用的目录角色，请使用请求的 roleTemplateId 参数中指定的目录角色模板的 ID 向/directoryRoles终结点发送 POST 请求。 成功完成此请求后，可以开始读取成员并将其分配到目录角色。 注意：为用户目录角色公开目录角色模板。 用户目录角色是隐式的，对目录客户端不可见。 租户中的每个用户都由基础结构分配给此角色。 角色已激活。 请勿使用此模板。

方法

方法	返回类型	说明
获取 directoryRoleTemplate	directoryRoleTemplate	读取 directoryroletemplate 对象的属性和关系。

属性

属性	类型	说明
说明	String	可设置目录角色说明。 只读。
displayName	String	可设置目录角色显示名称。 只读。
id	String	模板的的唯一标识符。 继承自 directoryObject。 在 POST 请求中指定 roleTemplateId 属性的目录角色模板的 id 将在租户中激活 directoryRole。 密钥，不可为 NULL。 只读。

关系

无

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)"
}