更新 windowsUpdateForBusinessConfiguration

命名空间: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。 用户定义允许用户设置。 默认情况下返回。 不支持查询参数。 可取值为:userDefinedhttpOnlyhttpWithPeeringNathttpWithPeeringPrivateGrouphttpWithInternetPeeringsimpleDownloadbypassMode
prereleaseFeatures prereleaseFeatures 预发布功能。 可能的值包括:UserDefined、SettingsOnly、SettingsAndExperimentations、NotAllowed。 UserDefined 是默认值,无意向。 默认情况下返回。 不支持查询参数。 可能的值是:userDefinedsettingsOnlysettingsAndExperimentationsnotAllowed
automaticUpdateMode automaticUpdateMode 自动更新模式。 可能的值包括:UserDefined、NotifyDownload、AutoInstallAtMaintenanceTime、AutoInstallAndRebootAtMaintenanceTime、AutoInstallAndRebootAtScheduledTime、AutoInstallAndRebootWithoutEndUserControl、WindowsDefault。 UserDefined 是默认值,无意向。 默认情况下返回。 不支持查询参数。 可取值为:userDefinednotifyDownloadautoInstallAtMaintenanceTimeautoInstallAndRebootAtMaintenanceTimeautoInstallAndRebootAtScheduledTimeautoInstallAndRebootWithoutEndUserControl
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。 默认情况下返回。 不支持查询参数。 可取值为:userDefinedallbusinessReadyOnlywindowsInsiderBuildFastwindowsInsiderBuildSlowwindowsInsiderBuildRelease
skipChecksBeforeRestart 布尔值 如果为 TRUE,则跳过重启前的所有检查:电池电量 = 40%,用户状态、需要显示、演示模式、全屏模式、电话呼叫状态、游戏模式等。如果为 FALSE,则不会在重启前跳过所有检查。 默认情况下返回。 不支持查询参数。
updateWeeks windowsUpdateForBusinessUpdateWeeks 计划每月几周的更新安装。 可能的值为:UserDefined、FirstWeek、SecondWeek、ThirdWeek、FourthWeek、EveryWeek。 默认情况下返回。 不支持查询参数。 可取值为:userDefinedfirstWeeksecondWeekthirdWeekfourthWeekeveryWeekunknownFutureValue
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。 默认情况下返回。 不支持查询参数。 可取值为:notConfiguredautomaticuserunknownFutureValue
scheduleRestartWarningInHours Int32 指定自动重启警告提醒通知的时间段。 支持的值:2、4、8、12 或 24 (小时) 。 默认返回。 不支持查询参数。
scheduleImminentRestartWarningInMinutes Int32 指定自动重启迫在眉睫的警告通知的时间段。 支持的值:15、30 或 60 (分钟) 。 默认返回。 不支持查询参数。
userPauseAccess 支持 指定是否允许最终用户访问暂停软件更新。 可能的值为:NotConfigured、Enabled、Disabled。 默认返回。 不支持查询参数。 可取值为:notConfiguredenableddisabled
userWindowsUpdateScanAccess 支持 指定是否禁用用户对扫描Windows 更新的访问权限。 可能的值为:NotConfigured、Enabled、Disabled。 默认情况下返回。 不支持查询参数。 可取值为:notConfiguredenableddisabled
updateNotificationLevel windowsUpdateNotificationDisplayOption 指定用户看到Windows 更新通知的内容。 可能的值为:NotConfigured、DefaultNotifications、RestartWarningsOnly、DisableAllNotifications。 默认情况下返回。 不支持查询参数。 可取值为:notConfigureddefaultNotificationsrestartWarningsOnlydisableAllNotificationsunknownFutureValue
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
}