命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示一组 设备 对象共有的属性值。 模板上的属性标记在基于此模板创建的任何 设备 对象上。 此对象是不可变的。
继承自 directoryObject。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | deviceTemplate 集合 | 获取在目录中注册的 deviceTemplate 对象的列表。 |
| 创建 | deviceTemplate | 创建一个新的 deviceTemplate ，用于识别属性和管理一组具有相似特征的设备。 |
| Get | deviceTemplate | 获取 deviceTemplate 对象的属性和关系。 |
| 删除 | 无 | 删除已注册的 deviceTemplate。 |
| List owners | directoryObject 集合 | 获取 deviceTemplate 对象的所有者列表。 |
| 添加所有者 | 无 | 向 deviceTemplate 对象添加新所有者。 |
| Remove owner | 无 | 从 deviceTemplate 对象中删除所有者。 |
| 从模板创建设备 | 设备 | 从 deviceTemplate 创建新设备。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| deletedDateTime | DateTimeOffset | 删除此对象的日期和时间。 在对象尚未删除时始终为 null。 继承自 directoryObject。 |
| deviceAuthority | String | 负责在 Microsoft Entra 租户上预配和管理设备的方的租户定义名称。 例如，Tailwind Traders (制造商) 制造安装在客户建筑物中并由 Lakeshore Retail (设备机构) 管理的安全摄像头。 此值由设备颁发机构 (制造商或经销商) 提供给客户。 |
| id | String | 对象的全局唯一标识符。 继承自 directoryObject。 只读。 支持 $filter（eq、in）。 |
| manufacturer | String | 制造商名称。 |
| model | String | 模型名称。 |
| mutualTlsOauthConfigurationId | String | mutualTlsOauthConfiguration 的对象 ID。 如果使用自签名证书，则不需要此值。 此值由设备颁发机构 (制造商或经销商) 提供给客户。 |
| mutualTlsOauthConfigurationTenantId | String | 包含 mutualTlsOauthConfiguration 的租户的设备颁发机构) 的 ID (租户 ID。 如果使用自签名证书，则不需要此值。 此值由设备颁发机构 (制造商或经销商) 提供给客户。 |
| operatingSystem | String | 操作系统类型。 支持 $filter（eq、in）。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| deviceInstances | 设备集合 | 基于此模板创建的 设备 对象的集合。 |
| owners | directoryObject collection | 可管理设备模板和相关 deviceInstances 的目录对象集合。 所有者可以表示为 服务主体、 用户或 应用程序。 所有者对设备模板拥有全部权限，无需其他管理员角色即可从此模板创建、更新或删除设备，以及添加或删除模板所有者。 设备模板上最多可以有 100 个所有者。 支持 $expand。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"@odata.type": "#microsoft.graph.deviceTemplate",
"deletedDateTime": "String (timestamp)",
"deviceAuthority": "String",
"id": "String (identifier)",
"manufacturer": "String",
"model": "String",
"mutualTlsOauthConfigurationId": "String",
"mutualTlsOauthConfigurationTenantId": "String",
"operatingSystem": "String"
}