命名空间：microsoft.graph
重要： Microsoft Graph 中 /beta 版本下的 API 可能会发生更改，这可能会中断应用程序。 虽然 Microsoft 支持Intune /beta API，但你应自行决定使用这些 API。 通常，建议不要在生产应用程序中使用 /beta API。 若要确定 API 在 v1.0 中是否可用，请使用版本选择器
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
BIOS 配置和其他设置使客户能够通过上传使用 OEM 工具 (生成的配置文件（例如 Dell 命令工具) ）在已注册的 Windows 10/11 Entra ID 加入的设备上配置硬件/bios 设置。 可将 BIOS 配置策略分配给多个设备，使管理员能够远程控制设备的硬件属性 (例如从 Intune 门户启用安全启动) 。 目前仅支持 Dell。
方法
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 已注册设备的硬件 BIOS 配置文件的唯一标识符。 此 ID 是 且是自动生成的，并在创建新的硬件 BIOS 配置文件时分配。 这会将配置文件彼此区分开来，不能为 null。 默认情况下返回。 只读。 |
| version | Int32 | 硬件配置的版本 (，例如 1、2、3 ...) 。在对 BIOS 配置文件的设置文件名 (FileName 属性) 、设置文件内容 (ConfigurationFileContent 属性) 或 PerDevicePasswordDisabled 属性进行更改后，此值会递增。 只读。 |
| displayName | String | 硬件 BIOS 配置文件的名称。 它用作用户友好名称，用于标识硬件 BIOS 配置文件。 最大长度为 150 个字符。 必填。 只读。 |
| description | String | 硬件配置的说明。 使用它可为组织的管理员提供 BIOS 配置文件的上下文、用途、应用程序等。 最大长度为 1000 个字符。 可选。 |
| createdDateTime | DateTimeOffset | BIOS 配置文件的创建日期和时间。 无法修改该值，并且会在注册设备时自动填充。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 (UTC) 如下所示：“2014-01-01T00:00:00Z”。 默认情况下返回。 只读。 此属性是只读的。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改 BIOS 配置文件的日期和时间。 无法修改该值，并且会在注册设备时自动填充。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 (UTC) 如下所示：“2014-01-01T00:00:00Z”。 默认情况下返回。 只读。 只读。 此属性是只读的。 |
| fileName | String | BIOS 配置文件的 ConfigurationFileContent 的文件名。 最大长度为 150 个字符。 必填。 |
| configurationFileContent | Binary | 文件内容包含将应用于已分配设备的 BIOS 的自定义硬件设置。 允许的最大文件大小为 5KB。 表示为字节。 必填。 |
| hardwareConfigurationFormat | hardwareConfigurationFormat | 与 BIOS 配置文件的自定义硬件设置关联的 OEM 类型。 符合配置文件的所有设备都必须来自同一选定的 OEM。 可能的值为 Dell、Surface 和 Surface 扩展坞。 必填。 可取值为：dell、surface、surfaceDock。 |
| roleScopeTagIds | 字符串集合 | 与硬件配置关联的唯一作用域标记 ID 的列表。 可选。 |
| perDevicePasswordDisabled | 布尔值 | 如果为 TRUE，则指示是否禁用策略分配的设备的密码。 如果为 FALSE，则指示它们已启用。 默认值为 FALSE。 必填。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| assignments | hardwareConfigurationAssignment 集合 | 硬件配置将应用到的 Entra 用户组 ID 的列表。 仅支持安全组和Office 365组。 可选。 |
| runSummary | hardwareConfigurationRunSummary | 尝试配置硬件设置的结果摘要。 只读。 |
| deviceRunStates | hardwareConfigurationDeviceState 集合 | 所有设备的硬件配置的运行状态列表。 只读。 |
| userRunStates | hardwareConfigurationUserState 集合 | 所有用户的硬件配置的运行状态列表。 只读。 |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.hardwareConfiguration",
"id": "String (identifier)",
"version": 1024,
"displayName": "String",
"description": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"fileName": "String",
"configurationFileContent": "binary",
"hardwareConfigurationFormat": "String",
"roleScopeTagIds": [
"String"
],
"perDevicePasswordDisabled": true
}