windowsUpdateForBusinessConfiguration 资源类型

  • 项目

命名空间：microsoft.graph

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

Windows 更新业务配置，允许你指定 Windows 即服务如何以及何时使用功能和质量更新更新Windows 10/11 设备。 支持 DeviceConfiguration 实体支持的 ODATA 子句：按 DeviceConfiguration 的类型$filter、$top、仅$select DeviceConfiguration 基本属性、仅$orderby DeviceConfiguration 基本属性和$skip。 不支持查询参数“$search”。

继承自 deviceConfiguration

方法

方法 返回类型 说明
List windowsUpdateForBusinessConfigurations windowsUpdateForBusinessConfiguration 集合 列出 windowsUpdateForBusinessConfiguration 对象的属性和关系。
Get windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration 读取 windowsUpdateForBusinessConfiguration 对象的属性和关系。
Create windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration 创建新的 windowsUpdateForBusinessConfiguration 对象。
Delete windowsUpdateForBusinessConfiguration 无 删除 windowsUpdateForBusinessConfiguration。
Update windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration 更新 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，则表示设备保留在现有操作系统上。 默认情况下返回。 不支持查询参数。

关系

关系 类型 说明
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
}