Create windowsUpdateForBusinessConfiguration

Пространство имен: microsoft.graph

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Создание объекта windowsUpdateForBusinessConfiguration.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

POST /deviceManagement/deviceConfigurations

Заголовки запроса

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept 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. 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 означает, что устройство остается в существующей операционной системе. Возвращается по умолчанию. Параметры запроса не поддерживаются.

Отклик

В случае успешного выполнения этот метод возвращает код ответа 201 Created и объект windowsUpdateForBusinessConfiguration в тексте ответа.

Пример

Запрос

Ниже приведен пример запроса.

POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
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 201 Created
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
}