windowsUpdateForBusinessConfiguration 资源类型
命名空间：microsoft.graph
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
Windows 更新业务配置，允许你指定 Windows 即服务如何以及何时使用功能和质量更新更新Windows 10/11 设备。 支持 DeviceConfiguration 实体支持的 ODATA 子句：按 DeviceConfiguration 的类型$filter、$top、仅$select DeviceConfiguration 基本属性、仅$orderby DeviceConfiguration 基本属性和$skip。 不支持查询参数“$search”。
方法
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 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，则表示设备保留在现有操作系统上。 默认返回。 不支持查询参数。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| assignments | deviceConfigurationAssignment 集合 | 设备配置文件的分配列表。 继承自 deviceConfiguration |
| deviceStatuses | deviceConfigurationDeviceStatus 集合 | 按设备的设备配置安装状态。 继承自 deviceConfiguration |
| userStatuses | deviceConfigurationUserStatus 集合 | 按用户排列的设备配置安装状态。 继承自 deviceConfiguration |
| deviceStatusOverview | deviceConfigurationDeviceOverview | 设备配置设备状态概述 继承自 deviceConfiguration |
| userStatusOverview | deviceConfigurationUserOverview | 设备配置用户状态概述 继承自 deviceConfiguration |
| deviceSettingStateSummaries | settingStateDeviceSummary 集合 | 设备配置设置状态设备摘要 继承自 deviceConfiguration |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"version": 1024,
"deliveryOptimizationMode": "String",
"prereleaseFeatures": "String",
"automaticUpdateMode": "String",
"microsoftUpdateServiceAllowed": true,
"driversExcluded": true,
"installationSchedule": {
"@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
"scheduledInstallDay": "String",
"scheduledInstallTime": "String (time of day)"
},
"qualityUpdatesDeferralPeriodInDays": 1024,
"featureUpdatesDeferralPeriodInDays": 1024,
"qualityUpdatesPaused": true,
"featureUpdatesPaused": true,
"qualityUpdatesPauseExpiryDateTime": "String (timestamp)",
"featureUpdatesPauseExpiryDateTime": "String (timestamp)",
"businessReadyUpdatesOnly": "String",
"skipChecksBeforeRestart": true,
"updateWeeks": "String",
"qualityUpdatesPauseStartDate": "String (Date)",
"featureUpdatesPauseStartDate": "String (Date)",
"featureUpdatesRollbackWindowInDays": 1024,
"qualityUpdatesWillBeRolledBack": true,
"featureUpdatesWillBeRolledBack": true,
"qualityUpdatesRollbackStartDateTime": "String (timestamp)",
"featureUpdatesRollbackStartDateTime": "String (timestamp)",
"engagedRestartDeadlineInDays": 1024,
"engagedRestartSnoozeScheduleInDays": 1024,
"engagedRestartTransitionScheduleInDays": 1024,
"deadlineForFeatureUpdatesInDays": 1024,
"deadlineForQualityUpdatesInDays": 1024,
"deadlineGracePeriodInDays": 1024,
"postponeRebootUntilAfterDeadline": true,
"autoRestartNotificationDismissal": "String",
"scheduleRestartWarningInHours": 1024,
"scheduleImminentRestartWarningInMinutes": 1024,
"userPauseAccess": "String",
"userWindowsUpdateScanAccess": "String",
"updateNotificationLevel": "String",
"allowWindows11Upgrade": true
}