命名空间：microsoft.graph
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
更新 windowsUpdateForBusinessConfiguration 对象的属性。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
要调用此 API，需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。
| 权限类型 | 权限（从最低特权到最高特权） |
|---|---|
| 委派（工作或学校帐户） | DeviceManagementConfiguration.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | 不支持。 |
| 应用程序 | DeviceManagementConfiguration.ReadWrite.All |
HTTP 请求
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
请求标头
| 标头 | 值 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| 接受 | application/json |
请求正文
在请求正文中，提供 windowsUpdateForBusinessConfiguration 对象的 JSON 表示形式。
下表显示创建 windowsUpdateForBusinessConfiguration 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 实体的键。 继承自 deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | 上次修改对象的日期/时间。 继承自 deviceConfiguration |
| createdDateTime | DateTimeOffset | 创建对象的日期/时间。 继承自 deviceConfiguration |
| description | String | 管理员提供的设备配置的说明。 继承自 deviceConfiguration |
| displayName | String | 管理员提供的设备配置的名称。 继承自 deviceConfiguration |
| version | Int32 | 设备配置的版本。 继承自 deviceConfiguration |
| deliveryOptimizationMode | windowsDeliveryOptimizationMode | 传递优化模式。 可能的值包括：UserDefined、HttpOnly、HttpWithPeeringNat、HttpWithPeeringPrivateGroup、HttpWithInternetPeering、SimpleDownload、BypassMode。 用户定义允许用户设置。 默认情况下返回。 不支持查询参数。 可取值包括：userDefined、httpOnly、httpWithPeeringNat、httpWithPeeringPrivateGroup、httpWithInternetPeering、simpleDownload、bypassMode。 |
| prereleaseFeatures | prereleaseFeatures | 预发布功能。 可能的值包括：UserDefined、SettingsOnly、SettingsAndExperimentations、NotAllowed。 UserDefined 是默认值，无意向。 默认情况下返回。 不支持查询参数。 可能的值包括 userDefined、settingsOnly、settingsAndExperimentations、notAllowed。 |
| automaticUpdateMode | automaticUpdateMode | 自动更新模式。 可能的值包括：UserDefined、NotifyDownload、AutoInstallAtMaintenanceTime、AutoInstallAndRebootAtMaintenanceTime、AutoInstallAndRebootAtScheduledTime、AutoInstallAndRebootWithoutEndUserControl、WindowsDefault。 UserDefined 是默认值，无意向。 默认情况下返回。 不支持查询参数。 可能的值包括 userDefined、notifyDownload、autoInstallAtMaintenanceTime、autoInstallAndRebootAtMaintenanceTime、autoInstallAndRebootAtScheduledTime、autoInstallAndRebootWithoutEndUserControl。 |
| microsoftUpdateServiceAllowed | 布尔值 | 如果为 TRUE，则允许Microsoft更新服务。 如果为 FALSE，则不允许Microsoft更新服务。 默认情况下返回。 不支持查询参数。 |
| driversExcluded | 布尔值 | 如果为 TRUE，则排除 Windows 更新驱动程序。 如果为 FALSE，则不排除 Windows 更新驱动程序。 默认情况下返回。 不支持查询参数。 |
| installationSchedule | windowsUpdateInstallScheduleType | 安装计划。 可能的值为：ActiveHoursStart、ActiveHoursEnd、ScheduledInstallDay、ScheduledInstallTime。 默认情况下返回。 不支持查询参数。 |
| qualityUpdatesDeferralPeriodInDays | Int32 | 将质量汇报推迟这么多天，有效范围为 0 到 30 天。 默认情况下返回。 不支持查询参数。 |
| featureUpdatesDeferralPeriodInDays | Int32 | 将功能汇报推迟这么多天，有效范围为 0 到 30 天。 默认情况下返回。 不支持查询参数。 |
| qualityUpdatesPaused | 布尔值 | 如果为 TRUE，则分配的设备将从暂停环开始最多 35 天内暂停接收质量更新。 如果为 FALSE，则不会暂停质量汇报。 默认情况下返回。 不支持查询参数。 |
| featureUpdatesPaused | 布尔值 | 如果为 TRUE，则从暂停响铃开始，已分配的设备将暂停接收功能更新长达 35 天。 如果为 FALSE，则不会暂停功能汇报。 默认情况下返回。 不支持查询参数。s |
| qualityUpdatesPauseExpiryDateTime | DateTimeOffset | 质量汇报暂停到期日期时间。 此值是从管理员暂停或延长圈的暂停时间起的 35 天。 默认情况下返回。 不支持查询参数。 |
| featureUpdatesPauseExpiryDateTime | DateTimeOffset | 功能汇报暂停到期日期时间。 此值是从管理员暂停或延长圈的暂停时间起的 35 天。 默认情况下返回。 不支持查询参数。 |
| businessReadyUpdatesOnly | windowsUpdateType | 确定将从哪个分支设备接收其更新。 可能的值包括：UserDefined、All、BusinessReadyOnly、WindowsInsiderBuildFast、WindowsInsiderBuildSlow、WindowsInsiderBuildRelease。 默认情况下返回。 不支持查询参数。 可能的值包括 userDefined、all、businessReadyOnly、windowsInsiderBuildFast、windowsInsiderBuildSlow、windowsInsiderBuildRelease。 |
| skipChecksBeforeRestart | 布尔值 | 如果为 TRUE，则跳过重启前的所有检查：电池电量 = 40%，用户状态、需要显示、演示模式、全屏模式、电话呼叫状态、游戏模式等。如果为 FALSE，则不会在重启前跳过所有检查。 默认情况下返回。 不支持查询参数。 |
| updateWeeks | windowsUpdateForBusinessUpdateWeeks | 计划每月几周的更新安装。 可能的值为：UserDefined、FirstWeek、SecondWeek、ThirdWeek、FourthWeek、EveryWeek。 默认情况下返回。 不支持查询参数。 可取值包括：userDefined、firstWeek、secondWeek、thirdWeek、fourthWeek、everyWeek、unknownFutureValue。 |
| qualityUpdatesPauseStartDate | 日期 | 质量汇报暂停开始日期。 此值是管理员暂停或延长环暂停的时间。 默认情况下返回。 不支持查询参数。 此属性是只读的。 |
| featureUpdatesPauseStartDate | 日期 | 功能汇报暂停开始日期。 此值是管理员暂停或延长环暂停的时间。 默认情况下返回。 不支持查询参数。 此属性是只读的。 |
| featureUpdatesRollbackWindowInDays | Int32 | 回退在功能更新后的天数，有效范围为 2 到 60 天。 默认情况下返回。 不支持查询参数。 |
| qualityUpdatesWillBeRolledBack | 布尔值 | 当为 TRUE 时，在检查的下一台设备上回滚质量汇报。 如果为 FALSE，则不要在检查的下一台设备上回滚质量汇报。 默认情况下返回。 不支持查询参数。 |
| featureUpdatesWillBeRolledBack | 布尔值 | 如果为 TRUE，则回滚功能汇报检查的下一台设备。 如果为 FALSE，则不要回滚下一个设备检查的功能汇报。 默认返回。不支持查询参数。 |
| qualityUpdatesRollbackStartDateTime | DateTimeOffset | 质量汇报回始日期时间。 此值是管理员回滚环的质量更新的时间。 默认情况下返回。 不支持查询参数。 |
| featureUpdatesRollbackStartDateTime | DateTimeOffset | 功能汇报回始日期时间。此值是管理员回滚环的功能更新的时间。默认返回。不支持查询参数。 |
| engagedRestartDeadlineInDays | Int32 | 在活动时段外自动安排和执行挂起的重启前的截止时间，有效范围为 2 到 30 天。 默认情况下返回。 不支持查询参数。 |
| engagedRestartSnoozeScheduleInDays | Int32 | 用户可以推迟参与重启提醒通知的天数，有效范围为 1 到 3 天。 默认情况下返回。 不支持查询参数。 |
| engagedRestartTransitionScheduleInDays | Int32 | 从活动时段外计划的“自动重启”转换为“参与重启”之前的天数，这要求用户进行计划，有效范围为 0 到 30 天。 默认情况下返回。 不支持查询参数。 |
| deadlineForFeatureUpdatesInDays | Int32 | 自动安装功能更新之前的天数，有效范围为 0 到 30 天。 默认情况下返回。 不支持查询参数。 |
| deadlineForQualityUpdatesInDays | Int32 | 质量更新自动安装之前的天数，有效范围为 0 到 30 天。 默认情况下返回。 不支持查询参数。 |
| deadlineGracePeriodInDays | Int32 | 截止时间之后的天数，直到自动重启，有效范围为 0 到 7 天。 默认情况下返回。 不支持查询参数。 |
| postponeRebootUntilAfterDeadline | 布尔值 | 当为 TRUE 时，设备应等到活动时段外重新启动的最后期限。 如果为 FALSE，则设备不应在活动时间之外等待重启截止时间。 默认情况下返回。 不支持查询参数。 |
| autoRestartNotificationDismissal | autoRestartNotificationDismissalMethod | 指定用于消除自动重启所需通知的方法。 可能的值为：NotConfigured、Automatic、User。 默认情况下返回。 不支持查询参数。 可能的值包括 notConfigured、automatic、user、unknownFutureValue。 |
| scheduleRestartWarningInHours | Int32 | 指定自动重启警告提醒通知的时间段。 支持的值：2、4、8、12 或 24 (小时) 。 默认情况下返回。 不支持查询参数。 |
| scheduleImminentRestartWarningInMinutes | Int32 | 指定自动重启迫在眉睫的警告通知的时间段。 支持的值：15、30 或 60 (分钟) 。 默认情况下返回。 不支持查询参数。 |
| userPauseAccess | 支持 | 指定是否允许最终用户访问暂停软件更新。 可能的值为：NotConfigured、Enabled、Disabled。 默认情况下返回。 不支持查询参数。 可能的值包括 notConfigured、enabled、disabled。 |
| userWindowsUpdateScanAccess | 支持 | 指定是否禁用用户对扫描Windows 更新的访问权限。 可能的值为：NotConfigured、Enabled、Disabled。 默认情况下返回。 不支持查询参数。 可能的值包括 notConfigured、enabled、disabled。 |
| updateNotificationLevel | windowsUpdateNotificationDisplayOption | 指定用户看到Windows 更新通知的内容。 可能的值为：NotConfigured、DefaultNotifications、RestartWarningsOnly、DisableAllNotifications。 默认情况下返回。 不支持查询参数。 可能的值包括 notConfigured、defaultNotifications、restartWarningsOnly、disableAllNotifications、unknownFutureValue。 |
| allowWindows11Upgrade | 布尔值 | 如果为 TRUE，则允许符合条件的Windows 10设备升级到Windows 11。 如果为 FALSE，则表示设备保留在现有作系统上。 默认情况下返回。 不支持查询参数。 |
响应
如果成功，此方法在响应正文中返回 200 OK 响应代码和更新的 windowsUpdateForBusinessConfiguration 对象。
示例
请求
下面是一个请求示例。
PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1963
{
"@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"deliveryOptimizationMode": "httpOnly",
"prereleaseFeatures": "settingsOnly",
"automaticUpdateMode": "notifyDownload",
"microsoftUpdateServiceAllowed": true,
"driversExcluded": true,
"installationSchedule": {
"@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
"scheduledInstallDay": "everyday",
"scheduledInstallTime": "11:59:31.3170000"
},
"qualityUpdatesDeferralPeriodInDays": 2,
"featureUpdatesDeferralPeriodInDays": 2,
"qualityUpdatesPaused": true,
"featureUpdatesPaused": true,
"qualityUpdatesPauseExpiryDateTime": "2017-01-01T00:00:22.9594683-08:00",
"featureUpdatesPauseExpiryDateTime": "2016-12-31T23:58:08.068669-08:00",
"businessReadyUpdatesOnly": "all",
"skipChecksBeforeRestart": true,
"updateWeeks": "firstWeek",
"qualityUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesRollbackWindowInDays": 2,
"qualityUpdatesWillBeRolledBack": true,
"featureUpdatesWillBeRolledBack": true,
"qualityUpdatesRollbackStartDateTime": "2016-12-31T23:57:01.05526-08:00",
"featureUpdatesRollbackStartDateTime": "2017-01-01T00:03:21.6080517-08:00",
"engagedRestartDeadlineInDays": 12,
"engagedRestartSnoozeScheduleInDays": 2,
"engagedRestartTransitionScheduleInDays": 6,
"deadlineForFeatureUpdatesInDays": 15,
"deadlineForQualityUpdatesInDays": 15,
"deadlineGracePeriodInDays": 9,
"postponeRebootUntilAfterDeadline": true,
"autoRestartNotificationDismissal": "automatic",
"scheduleRestartWarningInHours": 13,
"scheduleImminentRestartWarningInMinutes": 7,
"userPauseAccess": "enabled",
"userWindowsUpdateScanAccess": "enabled",
"updateNotificationLevel": "defaultNotifications",
"allowWindows11Upgrade": true
}
响应
下面是一个响应示例。 注意：为简洁起见，可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2135
{
"@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
"id": "4928dd6a-dd6a-4928-6add-28496add2849",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"deliveryOptimizationMode": "httpOnly",
"prereleaseFeatures": "settingsOnly",
"automaticUpdateMode": "notifyDownload",
"microsoftUpdateServiceAllowed": true,
"driversExcluded": true,
"installationSchedule": {
"@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
"scheduledInstallDay": "everyday",
"scheduledInstallTime": "11:59:31.3170000"
},
"qualityUpdatesDeferralPeriodInDays": 2,
"featureUpdatesDeferralPeriodInDays": 2,
"qualityUpdatesPaused": true,
"featureUpdatesPaused": true,
"qualityUpdatesPauseExpiryDateTime": "2017-01-01T00:00:22.9594683-08:00",
"featureUpdatesPauseExpiryDateTime": "2016-12-31T23:58:08.068669-08:00",
"businessReadyUpdatesOnly": "all",
"skipChecksBeforeRestart": true,
"updateWeeks": "firstWeek",
"qualityUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesRollbackWindowInDays": 2,
"qualityUpdatesWillBeRolledBack": true,
"featureUpdatesWillBeRolledBack": true,
"qualityUpdatesRollbackStartDateTime": "2016-12-31T23:57:01.05526-08:00",
"featureUpdatesRollbackStartDateTime": "2017-01-01T00:03:21.6080517-08:00",
"engagedRestartDeadlineInDays": 12,
"engagedRestartSnoozeScheduleInDays": 2,
"engagedRestartTransitionScheduleInDays": 6,
"deadlineForFeatureUpdatesInDays": 15,
"deadlineForQualityUpdatesInDays": 15,
"deadlineGracePeriodInDays": 9,
"postponeRebootUntilAfterDeadline": true,
"autoRestartNotificationDismissal": "automatic",
"scheduleRestartWarningInHours": 13,
"scheduleImminentRestartWarningInMinutes": 7,
"userPauseAccess": "enabled",
"userWindowsUpdateScanAccess": "enabled",
"updateNotificationLevel": "defaultNotifications",
"allowWindows11Upgrade": true
}