windowsAutopilotDeploymentProfile 资源类型

项目
11/21/2024

命名空间：microsoft.graph

重要： Microsoft /beta 版本下的 Graph API 可能会发生更改;不支持生产使用。

注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。

Windows Autopilot Deployment配置文件

方法

方法	返回类型	说明
获取 windowsAutopilotDeploymentProfile	windowsAutopilotDeploymentProfile	读取 windowsAutopilotDeploymentProfile 对象的属性和关系。
分配操作	None
策略集
hasPayloadLinks 操作	hasPayloadLinkResultItem 集合

属性

属性	类型	说明
id	String	配置文件密钥
displayName	String	部署配置文件的显示名称。允许的最大长度为 200 个字符。默认情况下返回。支持：$select、$top、$skip、$orderby。不支持$Search和$filter。
description	String	部署配置文件的说明。允许的最大长度为 1500 个字符。支持：$select、$top、$skip、$orderBy。不支持$Search和$filter。
language	String	配置设备时要使用的语言代码。例如 en-US。默认值为 os-default。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。只读。从 2024 年 5 月开始，该属性将不再受支持，并将标记为已弃用。请改用区域设置。
区域设置	String	区域设置 (配置设备时要使用的语言) 。例如 en-US。默认值为 os-default。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。
createdDateTime	DateTimeOffset	创建部署配置文件的日期和时间。无法修改该值，并且会在创建配置文件时自动填充。时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 时间。例如，2014 年 1 月 1 日午夜 (UTC) 如下所示：“2014-01-01T00:00:00Z”。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。只读。
lastModifiedDateTime	DateTimeOffset	上次修改部署配置文件的日期和时间。该值不能手动更新，并且会在对配置文件进行任何更改时自动填充。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 (UTC) 如下所示：“2014-01-01T00:00:00Z”。支持：$select、$top、$skip。 $Search、$orderBy和$filter不支持只读。
outOfBoxExperienceSettings	outOfBoxExperienceSettings	Autopilot 设备用于开箱即用体验的 Windows Autopilot Deployment 配置文件设置。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。只读。从 2024 年 5 月开始，该属性将不再受支持，并将标记为已弃用。请改用 outOfBoxExperienceSetting。
outOfBoxExperienceSetting	outOfBoxExperienceSetting	设备用于开箱即用体验的Windows Autopilot Deployment配置文件设置。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。
enrollmentStatusScreenSettings	windowsEnrollmentStatusScreenSettings	注册状态屏幕设置
extractHardwareHash	布尔值	指示配置文件是否支持提取硬件哈希值并将设备注册到 Windows Autopilot。如果为 TRUE，则指示下一次成功检查时是否会发生硬件提取和 Windows Autopilot 注册。如果为 FALSE，则不会进行硬件哈希提取和 Windows Autopilot 注册。默认值为 FALSE。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。只读。从 2024 年 5 月开始，该属性将不再受支持，并将标记为已弃用。请改用 hardwareHashExtractionEnabled。
hardwareHashExtractionEnabled	布尔值	指示配置文件是否支持提取硬件哈希值并将设备注册到 Windows Autopilot。如果为 TRUE，则指示下一次成功检查时是否会发生硬件提取和 Windows Autopilot 注册。如果为 FALSE，则不会进行硬件哈希提取和 Windows Autopilot 注册。默认值为 FALSE。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。
deviceNameTemplate	String	用于命名 Autopilot 设备的模板。这可以是自定义文本，也可以包含设备的序列号或随机生成的数字。模板生成的文本的总长度不能超过 15 个字符。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。
deviceType	windowsAutopilotDeviceType	此配置文件适用的 Windows 设备类型。可能的值包括 windowsPc、holoLens 和 virtualMachine。默认值为 windowsPc。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。可取值为：`windowsPc`、`holoLens`、`surfaceHub2`、`surfaceHub2S`、`virtualMachine`、`unknownFutureValue`。
enableWhiteGlove	布尔值	指示是否允许用户在“开箱即用”体验期间使用 Windows Autopilot 进行预预配部署模式， (OOBE) 。如果为 TRUE，则指示允许预预配部署模式的 Windows Autopilot。如果为 false，则不允许使用预预配部署模式的 Windows Autopilot。默认值为 FALSE。只读。从 2024 年 5 月开始，该属性将不再受支持，并将标记为已弃用。请改用 preprovisioningAllowed。
preprovisioningAllowed	布尔值	指示是否允许用户在“开箱即用”体验期间使用 Windows Autopilot 进行预预配部署模式， (OOBE) 。如果为 TRUE，则指示允许使用适用于 OOBE 的预预配部署模式的 Windows Autopilot。如果为 false，则不允许使用适用于 OOBE 的预预配部署模式的 Windows Autopilot。默认值为 FALSE。
roleScopeTagIds	字符串集合	部署配置文件的角色范围标记列表。
managementServiceAppId	String	在基于客户端设备的注册发现过程中使用的 Entra 管理服务应用 ID。支持：$select、$top、$skip。不支持$Search、$orderBy和$filter。

关系

关系	类型	说明
注册
assignedDevices	windowsAutopilotDeviceIdentity 集合	配置文件的已分配设备列表。
assignments	windowsAutopilotDeploymentProfileAssignment 集合	配置文件的组分配列表。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeploymentProfile",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "language": "String",
  "locale": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "outOfBoxExperienceSettings": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
    "hidePrivacySettings": true,
    "hideEULA": true,
    "userType": "String",
    "deviceUsageType": "String",
    "skipKeyboardSelectionPage": true,
    "hideEscapeLink": true
  },
  "outOfBoxExperienceSetting": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
    "privacySettingsHidden": true,
    "eulaHidden": true,
    "userType": "String",
    "deviceUsageType": "String",
    "keyboardSelectionPageSkipped": true,
    "escapeLinkHidden": true
  },
  "enrollmentStatusScreenSettings": {
    "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
    "hideInstallationProgress": true,
    "allowDeviceUseBeforeProfileAndAppInstallComplete": true,
    "blockDeviceSetupRetryByUser": true,
    "allowLogCollectionOnInstallFailure": true,
    "customErrorMessage": "String",
    "installProgressTimeoutInMinutes": 1024,
    "allowDeviceUseOnInstallFailure": true
  },
  "extractHardwareHash": true,
  "hardwareHashExtractionEnabled": true,
  "deviceNameTemplate": "String",
  "deviceType": "String",
  "enableWhiteGlove": true,
  "preprovisioningAllowed": true,
  "roleScopeTagIds": [
    "String"
  ],
  "managementServiceAppId": "String"
}

通过

windowsAutopilotDeploymentProfile 资源类型

方法

属性

关系

JSON 表示形式

反馈

其他资源