windowsUpdateForBusinessConfiguration 资源类型

项目
07/07/2022

命名空间：microsoft.graph

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

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

适用于企业的 Windows 更新配置。

方法

方法	返回类型	Description
List windowsUpdateForBusinessConfigurations	windowsUpdateForBusinessConfiguration 集合	列出 windowsUpdateForBusinessConfiguration 对象的属性和关系。
Get windowsUpdateForBusinessConfiguration	windowsUpdateForBusinessConfiguration	读取 windowsUpdateForBusinessConfiguration 对象的属性和关系。
Create windowsUpdateForBusinessConfiguration	windowsUpdateForBusinessConfiguration	创建新的 windowsUpdateForBusinessConfiguration 对象。
Delete windowsUpdateForBusinessConfiguration	无	删除 windowsUpdateForBusinessConfiguration。
Update windowsUpdateForBusinessConfiguration	windowsUpdateForBusinessConfiguration	更新 windowsUpdateForBusinessConfiguration 对象的属性。
extendFeatureUpdatesPause 操作	None	扩展功能更新暂停业务圈Windows 更新。
extendQualityUpdatesPause 操作	None	扩展业务圈Windows 更新的质量更新暂停。

属性

属性	类型	说明
id	字符串	实体的键。继承自 deviceConfiguration
lastModifiedDateTime	DateTimeOffset	上次修改对象的日期/时间。继承自 deviceConfiguration
roleScopeTagIds	字符串集合	此实体实例的范围标记列表。继承自 deviceConfiguration
supportsScopeTags	布尔	指示基础设备配置是否支持分配范围标记。如果此值为 false，并且作用域内用户不可见，则不允许分配到 ScopeTags 属性。对于在 Silverlight 中创建的旧策略，可以通过在 Azure 门户中删除和重新创建策略来解决此问题。此属性是只读的。继承自 deviceConfiguration
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	此策略的 OS 版本适用性。继承自 deviceConfiguration
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	此策略的 OS 版本适用性规则。继承自 deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	此策略的设备模式适用性规则。继承自 deviceConfiguration
createdDateTime	DateTimeOffset	创建对象的日期/时间。继承自 deviceConfiguration
说明	字符串	管理员提供的设备配置的说明。继承自 deviceConfiguration
displayName	String	管理员提供的设备配置的名称。继承自 deviceConfiguration
version	Int32	设备配置的版本。继承自 deviceConfiguration
deliveryOptimizationMode	windowsDeliveryOptimizationMode	传递优化模式。可取值为：`userDefined`、`httpOnly`、`httpWithPeeringNat`、`httpWithPeeringPrivateGroup`、`httpWithInternetPeering`、`simpleDownload` 或 `bypassMode`。
prereleaseFeatures	prereleaseFeatures	预发布功能。可取值为：`userDefined`、`settingsOnly`、`settingsAndExperimentations`、`notAllowed`。
automaticUpdateMode	automaticUpdateMode	自动更新模式。可取值为：`userDefined`、`notifyDownload`、`autoInstallAtMaintenanceTime`、`autoInstallAndRebootAtMaintenanceTime`、`autoInstallAndRebootAtScheduledTime`、`autoInstallAndRebootWithoutEndUserControl` 或 `windowsDefault`。
microsoftUpdateServiceAllowed	Boolean	允许 Microsoft 更新服务
driversExcluded	Boolean	排除 Windows 更新驱动程序
installationSchedule	windowsUpdateInstallScheduleType	安装计划
qualityUpdatesDeferralPeriodInDays	Int32	推迟质量更新的天数
featureUpdatesDeferralPeriodInDays	Int32	推迟功能更新的天数
qualityUpdatesPaused	Boolean	暂停质量更新
featureUpdatesPaused	Boolean	暂停功能更新
qualityUpdatesPauseExpiryDateTime	DateTimeOffset	质量更新暂停到期日期/时间
featureUpdatesPauseExpiryDateTime	DateTimeOffset	功能更新暂停到期日期/时间
businessReadyUpdatesOnly	windowsUpdateType	确定哪些分支设备将接收其更新。可取值为：`userDefined`、`all`、`businessReadyOnly`、`windowsInsiderBuildFast`、`windowsInsiderBuildSlow`、`windowsInsiderBuildRelease`。
skipChecksBeforeRestart	布尔	设置为在重启前跳过所有检查：电池级别 = 40%，用户状态、所需显示、演示模式、全屏模式、电话呼叫状态、游戏模式等。
updateWeeks	windowsUpdateForBusinessUpdateWeeks	在月份的几周内计划更新安装。可取值为：`userDefined`、`firstWeek`、`secondWeek`、`thirdWeek`、`fourthWeek`、`everyWeek`。
qualityUpdatesPauseStartDate	Date	质量更新暂停开始日期。此属性是只读的。
featureUpdatesPauseStartDate	Date	功能更新暂停开始日期。此属性是只读的。
featureUpdatesRollbackWindowInDays	Int32	回滚有效的功能更新后的天数
qualityUpdatesWillBeRolledBack	Boolean	指定是否在下一次设备签入时回滚质量更新
featureUpdatesWillBeRolledBack	Boolean	指定是否在下一个设备签入时回滚功能更新
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	Boolean	指定设备是否应等到在活动时间之外重新启动的截止时间
autoRestartNotificationDismissal	autoRestartNotificationDismissalMethod	指定消除自动重启所需通知的方法。可取值为：`notConfigured`、`automatic`、`user`。
scheduleRestartWarningInHours	Int32	指定自动重启警告提醒通知的时段。支持的值：2、4、8、12 或 24 (小时) 。
scheduleImminentRestartWarningInMinutes	Int32	指定自动重启即将发出的警告通知的时段。支持的值：15、30 或 60 (分钟) 。
userPauseAccess	支持	指定是否启用最终用户访问暂停软件更新。可取值为：`notConfigured`、`enabled`、`disabled`。
userWindowsUpdateScanAccess	支持	指定是否禁用用户访问扫描Windows 更新。可取值为：`notConfigured`、`enabled`、`disabled`。
updateNotificationLevel	windowsUpdateNotificationDisplayOption	指定用户看到的Windows 更新通知。可能的值是：`notConfigured`、`defaultNotifications`、`restartWarningsOnly`、`disableAllNotifications`。
allowWindows11Upgrade	布尔	允许符合条件的Windows 10设备升级到最新版本的Windows 11。

关系

关系	类型	Description
groupAssignments	deviceConfigurationGroupAssignment 集合	设备配置文件的组分配列表。继承自 deviceConfiguration
assignments	deviceConfigurationAssignment 集合	设备配置文件的分配列表。继承自 deviceConfiguration
deviceStatuses	deviceConfigurationDeviceStatus 集合	按设备的设备配置安装状态。继承自 deviceConfiguration
userStatuses	deviceConfigurationUserStatus 集合	按用户提供的设备配置安装状态。继承自 deviceConfiguration
deviceStatusOverview	deviceConfigurationDeviceOverview	设备配置设备状态概述继承自 deviceConfiguration
userStatusOverview	deviceConfigurationUserOverview	设备配置用户状态概述继承自 deviceConfiguration
deviceSettingStateSummaries	settingStateDeviceSummary 集合	设备配置设置状态设备摘要继承自 deviceConfiguration
deviceUpdateStates	windowsUpdateState 集合	适用于业务配置设备的 Windows 更新状态。该集合最多可包含 500 个元素。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "roleScopeTagIds": [
    "String"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "String"
    ],
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "String",
    "maxOSVersion": "String",
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "String",
    "name": "String",
    "ruleType": "String"
  },
  "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
}

windowsUpdateForBusinessConfiguration 资源类型

方法

属性

关系

JSON 表示形式

反馈