Compartir a través de


Crear windowsUpdateForBusinessConfiguration

Espacio de nombres: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Crear un objeto windowsUpdateForBusinessConfiguration.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

POST /deviceManagement/deviceConfigurations

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, especifique una representación JSON del objeto windowsUpdateForBusinessConfiguration.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto windowsUpdateForBusinessConfiguration.

Propiedad Tipo Descripción
id Cadena Clave de la entidad. Heredado de deviceConfiguration
lastModifiedDateTime DateTimeOffset Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceConfiguration
createdDateTime DateTimeOffset Fecha y hora en la que se creó el objeto. Heredado de deviceConfiguration
description Cadena Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration
displayName Cadena Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration
version Int32 Versión de la configuración del dispositivo. Heredado de deviceConfiguration
deliveryOptimizationMode windowsDeliveryOptimizationMode Modo de optimización de entrega. Los valores posibles son: UserDefined, HttpOnly, HttpWithPeeringNat, HttpWithPeeringPrivateGroup, HttpWithInternetPeering, SimpleDownload, BypassMode. UserDefined permite al usuario establecer. Se devuelve por defecto. No se admiten los parámetros de consulta. Valores posibles: userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload, bypassMode.
prereleaseFeatures prereleaseFeatures Características de la versión preliminar. Los valores posibles son: UserDefined, SettingsOnly, SettingsAndExperimentations, NotAllowed. UserDefined es el valor predeterminado, sin intención. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta. Los valores posibles son: userDefined, settingsOnly, settingsAndExperimentations y notAllowed.
automaticUpdateMode automaticUpdateMode Modo de actualización automática. Los valores posibles son: UserDefined, NotifyDownload, AutoInstallAtMaintenanceTime, AutoInstallAndRebootAtMaintenanceTime, AutoInstallAndRebootAtScheduledTime, AutoInstallAndRebootWithoutEndUserControl, WindowsDefault. UserDefined es el valor predeterminado, sin intención. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta. Los valores posibles son: userDefined, notifyDownload, autoInstallAtMaintenanceTime, autoInstallAndRebootAtMaintenanceTime, autoInstallAndRebootAtScheduledTime, autoInstallAndRebootWithoutEndUserControl.
microsoftUpdateServiceAllowed Booleano Cuando es TRUE, permite Microsoft Update Service. Cuando es FALSE, no permite Microsoft Update Service. Se devuelve por defecto. No se admiten los parámetros de consulta.
driversExcluded Booleano Cuando es TRUE, excluye controladores de actualización de Windows. Cuando es FALSE, no excluye controladores de Windows Update. Se devuelve por defecto. No se admiten los parámetros de consulta.
installationSchedule windowsUpdateInstallScheduleType Programación de instalación. Los valores posibles son: ActiveHoursStart, ActiveHoursEnd, ScheduledInstallDay, ScheduledInstallTime. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
qualityUpdatesDeferralPeriodInDays Int32 Aplazar la calidad Novedades en estos muchos días con un intervalo válido de 0 a 30 días. Se devuelve por defecto. No se admiten los parámetros de consulta.
featureUpdatesDeferralPeriodInDays Int32 Aplazar la Novedades de características en estos muchos días con un intervalo válido de 0 a 30 días. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
qualityUpdatesPaused Booleano Cuando es TRUE, los dispositivos asignados se pausan para recibir actualizaciones de calidad durante un máximo de 35 días a partir del momento en que pausa el anillo. Cuando es FALSE, no pausa la Novedades de calidad. Se devuelve por defecto. No se admiten los parámetros de consulta.
featureUpdatesPaused Booleano Cuando es TRUE, los dispositivos asignados se pausan para recibir actualizaciones de características durante un máximo de 35 días desde el momento en que pausa el anillo. Cuando es FALSE, no pausa la Novedades de características. Se devuelve por defecto. No se admiten los parámetros de consulta.
qualityUpdatesPauseExpiryDateTime DateTimeOffset Quality Novedades Pausar fecha y hora de expiración. Este valor es de 35 días a partir del momento en que el administrador ha pausado o ampliado la pausa para el anillo. Se devuelve por defecto. No se admiten los parámetros de consulta.
featureUpdatesPauseExpiryDateTime DateTimeOffset La característica Novedades pausar la fecha y hora de expiración. Este valor es de 35 días a partir del momento en que el administrador ha pausado o ampliado la pausa para el anillo. Se devuelve por defecto. No se admiten los parámetros de consulta.
businessReadyUpdatesOnly windowsUpdateType Determina de qué dispositivos de rama recibirán sus actualizaciones. Los valores posibles son: UserDefined, All, BusinessReadyOnly, WindowsInsiderBuildFast, WindowsInsiderBuildSlow, WindowsInsiderBuildRelease. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta. Los valores posibles son: userDefined, all, businessReadyOnly, windowsInsiderBuildFast, windowsInsiderBuildSlow, windowsInsiderBuildRelease.
skipChecksBeforeRestart Booleano Cuando es TRUE, omite todas las comprobaciones antes del reinicio: nivel de batería = 40 %, presencia del usuario, pantalla necesaria, modo de presentación, modo de pantalla completa, estado de llamada telefónica, modo de juego, etc. Cuando es FALSE, no omite todas las comprobaciones antes del reinicio. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
updateWeeks windowsUpdateForBusinessUpdateWeeks Programe la instalación de la actualización en las semanas del mes. Los valores posibles son: UserDefined, FirstWeek, SecondWeek, ThirdWeek, FourthWeek, EveryWeek. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta. Valores posibles: userDefined, firstWeek, secondWeek, thirdWeek, fourthWeek, everyWeek, unknownFutureValue.
qualityUpdatesPauseStartDate Fecha Fecha de inicio Novedades Pausa de calidad. Este valor es la hora en que el administrador pausa o extiende la pausa para el anillo. Se devuelve por defecto. No se admiten los parámetros de consulta. Esta propiedad es de sólo lectura.
featureUpdatesPauseStartDate Fecha La fecha de inicio de la característica Novedades pausa. Este valor es la hora en que el administrador pausa o extiende la pausa para el anillo. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta. Esta propiedad es de sólo lectura.
featureUpdatesRollbackWindowInDays Int32 Número de días después de una actualización de características para la que una reversión es válida con un intervalo válido de 2 a 60 días. Se devuelve por defecto. No se admiten los parámetros de consulta.
qualityUpdatesWillBeRolledBack Booleano Cuando es TRUE, la calidad de reversión Novedades en la siguiente comprobación del dispositivo. Cuando sea FALSE, no revierta la Novedades de calidad en la siguiente comprobación del dispositivo. Se devuelve por defecto. No se admiten los parámetros de consulta.
featureUpdatesWillBeRolledBack Booleano Cuando es TRUE, la característica de reversión Novedades en la siguiente comprobación del dispositivo. Cuando sea FALSE, no revierta la característica Novedades en la siguiente comprobación del dispositivo. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
qualityUpdatesRollbackStartDateTime DateTimeOffset La fecha y hora de inicio de reversión de calidad Novedades. Este valor es el momento en que el administrador revierte la actualización de calidad para el anillo. Se devuelve por defecto. No se admiten los parámetros de consulta.
featureUpdatesRollbackStartDateTime DateTimeOffset La característica Novedades fecha y hora de inicio de reversión. Este valor es la hora en que el administrador revierte la actualización de características para el anillo. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
engagedRestartDeadlineInDays Int32 Fecha límite en días antes de programar y ejecutar automáticamente un reinicio pendiente fuera del horario activo, con un intervalo válido de 2 a 30 días. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
engagedRestartSnoozeScheduleInDays Int32 Número de días que un usuario puede posponer notificaciones de recordatorio de reinicio comprometido con un intervalo válido de 1 a 3 días. Se devuelve por defecto. No se admiten los parámetros de consulta.
engagedRestartTransitionScheduleInDays Int32 Número de días antes de realizar la transición de Reinicios automáticos programados fuera del horario activo a Reinicio comprometido, lo que requiere que el usuario lo programe, con un intervalo válido de 0 a 30 días. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
deadlineForFeatureUpdatesInDays Int32 Número de días antes de que las actualizaciones de características se instalen automáticamente con un intervalo válido de 0 a 30 días. Se devuelve por defecto. No se admiten los parámetros de consulta.
deadlineForQualityUpdatesInDays Int32 Número de días antes de que las actualizaciones de calidad se instalen automáticamente con un intervalo válido de 0 a 30 días. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
deadlineGracePeriodInDays Int32 Número de días después de la fecha límite hasta que los reinicios se produzcan automáticamente con un intervalo válido de 0 a 7 días. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
postponeRebootUntilAfterDeadline Booleano Cuando es TRUE, el dispositivo debe esperar hasta la fecha límite para reiniciarse fuera de las horas activas. Cuando es FALSE, el dispositivo no debe esperar hasta la fecha límite para reiniciarse fuera del horario activo. Se devuelve por defecto. No se admiten los parámetros de consulta.
autoRestartNotificationDismissal autoRestartNotificationDismissalMethod Especifique el método por el que se descarta la notificación necesaria de reinicio automático. Los valores posibles son: NotConfigured, Automatic, User. Se devuelve por defecto. No se admiten los parámetros de consulta. Los valores posibles son: notConfigured, automatic, user y unknownFutureValue.
scheduleRestartWarningInHours Int32 Especifique el período para las notificaciones de aviso de advertencia de reinicio automático. Valores admitidos: 2, 4, 8, 12 o 24 (horas). Se devuelve por defecto. No se admiten los parámetros de consulta.
scheduleImminentRestartWarningInMinutes Int32 Especifique el período para las notificaciones de advertencia inminentes de reinicio automático. Valores admitidos: 15, 30 o 60 (minutos). Se devuelve por defecto. No se admiten los parámetros de consulta.
userPauseAccess habilitación Especifica si se va a habilitar el acceso del usuario final para pausar las actualizaciones de software. Los valores posibles son: NotConfigured, Enabled, Disabled. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta. Los valores posibles son: notConfigured, enabled y disabled.
userWindowsUpdateScanAccess habilitación Especifica si se va a deshabilitar el acceso del usuario para examinar Windows Update. Los valores posibles son: NotConfigured, Enabled, Disabled. Se devuelve por defecto. No se admiten los parámetros de consulta. Los valores posibles son: notConfigured, enabled y disabled.
updateNotificationLevel windowsUpdateNotificationDisplayOption Especifica qué Windows Update notificaciones ven los usuarios. Los valores posibles son: NotConfigured, DefaultNotifications, RestartWarningsOnly, DisableAllNotifications. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta. Los valores posibles son: notConfigured, defaultNotifications, restartWarningsOnly, disableAllNotifications y unknownFutureValue.
allowWindows11Upgrade Booleano Cuando es TRUE, permite que los dispositivos de Windows 10 aptos se actualicen a Windows 11. Cuando es FALSE, implica que el dispositivo permanece en el sistema operativo existente. Se devuelve por defecto. No se admiten los parámetros de consulta.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto windowsUpdateForBusinessConfiguration en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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
}