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.
Windows Update para la configuración empresarial, 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 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 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 por defecto. 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 de forma predeterminada. 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 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 por defecto. 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 por defecto. 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 por defecto. 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 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 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 por defecto. 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 por defecto. 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 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 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 por defecto. 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 por defecto. 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. |
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
}