Tipo de recurso windowsUpdateForBusinessConfiguration

Espacio de nombres: microsoft.graph

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

La configuración de Windows Update para empresas permite especificar cómo y cuándo Windows como servicio actualiza los dispositivos Windows 10/11 con actualizaciones de características y calidad. Admite cláusulas ODATA compatibles con la entidad DeviceConfiguration: $filter por tipos de DeviceConfiguration, $top, $select solo propiedades base DeviceConfiguration, $orderby solo propiedades base DeviceConfiguration y $skip. No se admite el parámetro de consulta "$search".

Hereda de deviceConfiguration

Métodos

Método Tipo de valor devuelto Descripción
Enumerar windowsUpdateForBusinessConfigurations Colección windowsUpdateForBusinessConfiguration Enumere las propiedades y las relaciones de los objetos windowsUpdateForBusinessConfiguration.
Obtener windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration Lea las propiedades y las relaciones del objeto windowsUpdateForBusinessConfiguration.
Crear windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration Cree un objeto windowsUpdateForBusinessConfiguration.
Eliminar windowsUpdateForBusinessConfiguration Ninguna Elimina un windowsUpdateForBusinessConfiguration.
Actualizar windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration Actualice las propiedades de un objeto windowsUpdateForBusinessConfiguration.

Propiedades

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 de forma predeterminada. 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 por defecto. 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 de forma predeterminada. 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 de forma predeterminada. 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 por defecto. No se admiten los parámetros de consulta.
qualityUpdatesDeferralPeriodInDays Int32 Aplazar las actualizaciones de calidad 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.
featureUpdatesDeferralPeriodInDays Int32 Aplazar las actualizaciones 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 las actualizaciones de calidad. Se devuelve de forma predeterminada. 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 las actualizaciones de características. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
qualityUpdatesPauseExpiryDateTime DateTimeOffset Las actualizaciones de calidad pausan 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 de forma predeterminada. No se admiten los parámetros de consulta.
featureUpdatesPauseExpiryDateTime DateTimeOffset Las actualizaciones de características pausan 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 de forma predeterminada. 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 etcetera. 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 de pausa de actualizaciones de calidad. 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.
featureUpdatesPauseStartDate Fecha Las actualizaciones de características pausan la fecha de inicio. 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 de forma predeterminada. No se admiten los parámetros de consulta.
qualityUpdatesWillBeRolledBack Booleano Cuando es TRUE, revierta las actualizaciones de calidad en la siguiente comprobación del dispositivo. Cuando sea FALSE, no revierta actualizaciones de calidad en la siguiente protección del dispositivo. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
featureUpdatesWillBeRolledBack Booleano Cuando es TRUE, revierta las actualizaciones de características en la siguiente comprobación del dispositivo. Cuando sea FALSE, no revierta las actualizaciones de características en la siguiente protección del dispositivo. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
qualityUpdatesRollbackStartDateTime DateTimeOffset Fecha y hora de inicio de reversión de actualizaciones de calidad. Este valor es el momento en que el administrador revierte la actualización de calidad para el anillo. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.
featureUpdatesRollbackStartDateTime DateTimeOffset Fecha y hora de inicio de reversión de actualizaciones de características. 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 por defecto. 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 de forma predeterminada. 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 de forma predeterminada. 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 de forma predeterminada. 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 de forma predeterminada. 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 de forma predeterminada. 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 de forma predeterminada. 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 de forma predeterminada. No se admiten los parámetros de consulta. Los valores posibles son: notConfigured, enabled y disabled.
updateNotificationLevel windowsUpdateNotificationDisplayOption Especifica lo que ven los usuarios de notificaciones de Windows Update. 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 Windows 10 aptos se actualicen a Windows 11. Cuando es FALSE, implica que el dispositivo permanece en el sistema operativo existente. Se devuelve de forma predeterminada. No se admiten los parámetros de consulta.

Relaciones

Relación Tipo Descripción
assignments Colección deviceConfigurationAssignment La lista de tareas para el perfil de configuración del dispositivo. Heredado de deviceConfiguration
deviceStatuses Colección deviceConfigurationDeviceStatus Estado de instalación de configuración del dispositivo por dispositivo. Heredado de deviceConfiguration
userStatuses Colección deviceConfigurationUserStatus Estado de instalación de la configuración del dispositivo por usuario. Heredado de deviceConfiguration
deviceStatusOverview deviceConfigurationDeviceOverview Información general sobre el estado de dispositivos de la configuración de dispositivo. Heredado de deviceConfiguration
userStatusOverview deviceConfigurationUserOverview Información general sobre el estado de usuarios de la configuración de dispositivo. Heredado de deviceConfiguration
deviceSettingStateSummaries Colección settingStateDeviceSummary Resumen de dispositivo sobre el estado de configuración de la configuración de dispositivo. Heredado de deviceConfiguration

Representación JSON

Aquí tiene una representación JSON del recurso.

{
  "@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
}