Тип ресурса windowsUpdateForBusinessConfiguration
Пространство имен: microsoft.graph
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
клиентский компонент Центра обновления Windows для бизнес-конфигурации позволяет указать, как и когда Windows как услуга обновляет устройства Windows 10/11 обновлениями функций и качества. Поддерживает предложения ODATA, поддерживаемые сущностью DeviceConfiguration: $filter по типам DeviceConfiguration, $top, $select только базовым свойствам DeviceConfiguration, $orderby только базовым свойствам DeviceConfiguration и $skip. Параметр запроса "$search" не поддерживается.
Наследуется от deviceConfiguration.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Перечисление windowsUpdateForBusinessConfigurations | Коллекция windowsUpdateForBusinessConfiguration | Перечисление свойств и связей объектов windowsUpdateForBusinessConfiguration. |
| Получение windowsUpdateForBusinessConfiguration | windowsUpdateForBusinessConfiguration | Считывание свойств и связей объекта windowsUpdateForBusinessConfiguration. |
| Создание windowsUpdateForBusinessConfiguration | windowsUpdateForBusinessConfiguration | Создание нового объекта windowsUpdateForBusinessConfiguration. |
| Удаление windowsUpdateForBusinessConfiguration | None | Удаление экземпляра windowsUpdateForBusinessConfiguration. |
| Обновление 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 позволяет пользователю задать. Возвращается по умолчанию. Параметры запроса не поддерживаются. Возможные значения: 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, разрешает службу Центра обновления Майкрософт. Значение FALSE не разрешает службу Центра обновления Майкрософт. Возвращается по умолчанию. Параметры запроса не поддерживаются. |
| 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 | Date | Дата начала Обновления "Качество". Это значение — время, когда администратор приостановил или продлил паузу для круга. Возвращается по умолчанию. Параметры запроса не поддерживаются. Это свойство доступно только для чтения. |
| featureUpdatesPauseStartDate | Date | Функция Обновления приостановить дату начала. Это значение — время, когда администратор приостановил или продлил паузу для круга. Возвращается по умолчанию. Параметры запроса не поддерживаются. Это свойство доступно только для чтения. |
| 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
}