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
}