Type de ressource windowsUpdateForBusinessConfiguration
Espace de noms: microsoft.graph
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Windows Update pour les entreprises, vous permet de spécifier comment et quand Windows as a Service met à jour vos appareils Windows 10/11 avec des mises à jour de fonctionnalités et de qualité. Prend en charge les clauses ODATA prises en charge par l’entité DeviceConfiguration : $filter par types de DeviceConfiguration, $top, $select uniquement les propriétés de base DeviceConfiguration, $orderby uniquement les propriétés de base DeviceConfiguration et $skip. Le paramètre de requête « $search » n’est pas pris en charge.
Hérite de deviceConfiguration.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| List windowsUpdateForBusinessConfigurations | Collection windowsUpdateForBusinessConfiguration | Répertorie les propriétés et les relations de l’objet windowsUpdateForBusinessConfiguration. |
| Get windowsUpdateForBusinessConfiguration | windowsUpdateForBusinessConfiguration | Lit les propriétés et relations de l’objet windowsUpdateForBusinessConfiguration. |
| Create windowsUpdateForBusinessConfiguration | windowsUpdateForBusinessConfiguration | Crée un objet windowsUpdateForBusinessConfiguration. |
| Delete windowsUpdateForBusinessConfiguration | Aucun | Supprime un objet windowsUpdateForBusinessConfiguration. |
| Update windowsUpdateForBusinessConfiguration | windowsUpdateForBusinessConfiguration | Met à jour les propriétés d’un objet windowsUpdateForBusinessConfiguration. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| id | String | Clé de l’entité. Hérité de deviceConfiguration. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de dernière modification de l’objet. Hérité de deviceConfiguration. |
| createdDateTime | DateTimeOffset | Date et heure de création de l’objet. Hérité de deviceConfiguration. |
| description | String | Description de la configuration de l’appareil fournie par l’administrateur. Hérité de deviceConfiguration. |
| displayName | String | Nom de la configuration de l’appareil fourni par l’administrateur. Hérité de deviceConfiguration. |
| version | Int32 | Version de la configuration de l’appareil. Hérité de deviceConfiguration. |
| deliveryOptimizationMode | windowsDeliveryOptimizationMode | Mode d’optimisation de la distribution. Les valeurs possibles sont : UserDefined, HttpOnly, HttpWithPeeringNat, HttpWithPeeringPrivateGroup, HttpWithInternetPeering, SimpleDownload, BypassMode. UserDefined permet à l’utilisateur de définir. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont les suivantes : userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload et bypassMode. |
| prereleaseFeatures | prereleaseFeatures | Fonctionnalités de préversion. Les valeurs possibles sont : UserDefined, SettingsOnly, SettingsAndExperimentations, NotAllowed. UserDefined est la valeur par défaut, aucune intention. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont les suivantes : userDefined, settingsOnly, settingsAndExperimentations, notAllowed. |
| automaticUpdateMode | automaticUpdateMode | Mode de mise à jour automatique. Les valeurs possibles sont : UserDefined, NotifyDownload, AutoInstallAtMaintenanceTime, AutoInstallAndRebootAtMaintenanceTime, AutoInstallAndRebootAtScheduledTime, AutoInstallAndRebootWithoutEndUserControl, WindowsDefault. UserDefined est la valeur par défaut, aucune intention. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont userDefined, notifyDownload, autoInstallAtMaintenanceTime, autoInstallAndRebootAtMaintenanceTime, autoInstallAndRebootAtScheduledTime, autoInstallAndRebootWithoutEndUserControl. |
| microsoftUpdateServiceAllowed | Boolean | Lorsque la valeur est TRUE, autorise Microsoft Update Service. Si la valeur est FALSE, n’autorise pas Microsoft Update Service. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| driversExcluded | Boolean | Si la valeur est TRUE, exclut les pilotes windows update. Si la valeur est FALSE, n’exclut pas les pilotes Windows Update. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| installationSchedule | windowsUpdateInstallScheduleType | Planification de l’installation. Les valeurs possibles sont : ActiveHoursStart, ActiveHoursEnd, ScheduledInstallDay, ScheduledInstallTime. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| qualityUpdatesDeferralPeriodInDays | Int32 | Différer la qualité Mises à jour de ces nombreux jours avec une plage valide comprise entre 0 et 30 jours. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesDeferralPeriodInDays | Int32 | Différer les Mises à jour de fonctionnalités de ces nombreux jours avec une plage valide comprise entre 0 et 30 jours. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| qualityUpdatesPaused | Boolean | Lorsque la valeur est TRUE, les appareils affectés sont suspendus de la réception des mises à jour qualité pendant 35 jours maximum à partir du moment où vous suspendez l’anneau. Lorsque la valeur est FALSE, ne met pas en pause la qualité Mises à jour. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesPaused | Boolean | Lorsque la valeur est TRUE, les appareils affectés sont suspendus de la réception des mises à jour des fonctionnalités pendant 35 jours maximum à partir du moment où vous suspendez l’anneau. Lorsque la valeur est FALSE, ne suspend pas le Mises à jour de fonctionnalité. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge.s |
| qualityUpdatesPauseExpiryDateTime | DateTimeOffset | Date/heure d’expiration de la qualité Mises à jour pause. Cette valeur est de 35 jours à compter du moment où l’administrateur a suspendu ou étendu la pause pour l’anneau. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesPauseExpiryDateTime | DateTimeOffset | La fonctionnalité Mises à jour suspendre la date et l’heure d’expiration. Cette valeur est de 35 jours à compter du moment où l’administrateur a suspendu ou étendu la pause pour l’anneau. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| businessReadyUpdatesOnly | windowsUpdateType | Détermine les appareils de branche qui recevront leurs mises à jour. Les valeurs possibles sont : UserDefined, All, BusinessReadyOnly, WindowsInsiderBuildFast, WindowsInsiderBuildSlow, WindowsInsiderBuildRelease. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont userDefined, all, businessReadyOnly, windowsInsiderBuildFast, windowsInsiderBuildSlow, windowsInsiderBuildRelease. |
| skipChecksBeforeRestart | Boolean | Lorsque la valeur est TRUE, ignore toutes les vérifications avant le redémarrage : niveau de la batterie = 40 %, présence de l’utilisateur, affichage nécessaire, mode présentation, mode Plein écran, état de l’appel téléphonique, mode jeu, etc. Si la valeur est FALSE, n’ignore pas toutes les vérifications avant le redémarrage. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| updateWeeks | windowsUpdateForBusinessUpdateWeeks | Planifiez l’installation de la mise à jour sur les semaines du mois. Les valeurs possibles sont : UserDefined, FirstWeek, SecondWeek, ThirdWeek, FourthWeek, EveryWeek. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont les suivantes : userDefined, firstWeek, secondWeek, thirdWeek, fourthWeek, everyWeek et unknownFutureValue. |
| qualityUpdatesPauseStartDate | Date | Date de début de la mise en pause Mises à jour qualité. Cette valeur correspond à l’heure à laquelle l’administrateur a suspendu ou prolongé la pause pour l’anneau. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Cette propriété est en lecture seule. |
| featureUpdatesPauseStartDate | Date | Date de début de la fonctionnalité Mises à jour Suspendre. Cette valeur correspond à l’heure à laquelle l’administrateur a suspendu ou prolongé la pause pour l’anneau. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Cette propriété est en lecture seule. |
| featureUpdatesRollbackWindowInDays | Int32 | Nombre de jours après une mise à jour de fonctionnalité pour laquelle une restauration est valide avec une plage valide comprise entre 2 et 60 jours. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| qualityUpdatesWillBeRolledBack | Boolean | Lorsque la valeur est TRUE, la restauration de quality Mises à jour sur l’appareil suivant case activée. Lorsque la valeur est FALSE, ne restaurez pas les Mises à jour qualité sur l’appareil suivant case activée. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesWillBeRolledBack | Boolean | Lorsque la valeur est TRUE, la fonctionnalité de restauration Mises à jour sur l’appareil suivant case activée. Lorsque la valeur est FALSE, ne restaurez pas les Mises à jour de fonctionnalité sur l’appareil suivant case activée. Retourné par défaut. Les paramètres de requête ne sont pas pris en charge. |
| qualityUpdatesRollbackStartDateTime | DateTimeOffset | Quality Mises à jour Rollback Start datetime. Cette valeur correspond à l’heure à laquelle l’administrateur a restauré la mise à jour qualité pour l’anneau. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesRollbackStartDateTime | DateTimeOffset | La fonctionnalité Mises à jour date/heure de début de la restauration. Cette valeur correspond à l’heure à laquelle l’administrateur a restauré la mise à jour des fonctionnalités pour l’anneau. Retourné par défaut. Les paramètres de requête ne sont pas pris en charge. |
| engagedRestartDeadlineInDays | Int32 | Délai en jours avant la planification et l’exécution automatiques d’un redémarrage en attente en dehors des heures d’activité, avec une plage valide comprise entre 2 et 30 jours. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| engagedRestartSnoozeScheduleInDays | Int32 | Nombre de jours pendant lesquels un utilisateur peut répéter les notifications de rappel de redémarrage engagé avec une plage valide comprise entre 1 et 3 jours. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| engagedRestartTransitionScheduleInDays | Int32 | Nombre de jours avant la transition des redémarrages automatiques planifiés en dehors des heures d’activité à redémarrage engagé, ce qui nécessite que l’utilisateur planifie, avec une plage valide comprise entre 0 et 30 jours. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| deadlineForFeatureUpdatesInDays | Int32 | Nombre de jours avant l’installation automatique des mises à jour des fonctionnalités avec une plage valide comprise entre 0 et 30 jours. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| deadlineForQualityUpdatesInDays | Int32 | Nombre de jours avant l’installation automatique des mises à jour qualité avec une plage valide comprise entre 0 et 30 jours. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| deadlineGracePeriodInDays | Int32 | Nombre de jours après l’échéance jusqu’à ce que les redémarrages se produisent automatiquement avec une plage valide comprise entre 0 et 7 jours. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| postponeRebootUntilAfterDeadline | Boolean | Lorsque la valeur est TRUE, l’appareil doit attendre la date limite de redémarrage en dehors des heures d’activité. Lorsque la valeur est FALSE, l’appareil ne doit pas attendre la date limite de redémarrage en dehors des heures d’activité. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| autoRestartNotificationDismissal | autoRestartNotificationDismissalMethod | Spécifiez la méthode par laquelle la notification requise de redémarrage automatique est ignorée. Les valeurs possibles sont : NotConfigured, Automatic, User. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont les suivantes : notConfigured, automatic, user, unknownFutureValue. |
| scheduleRestartWarningInHours | Int32 | Spécifiez la période pour les notifications de rappel d’avertissement de redémarrage automatique. Valeurs prises en charge : 2, 4, 8, 12 ou 24 (heures). Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
| scheduleImminentRestartWarningInMinutes | Int32 | Spécifiez la période pour les notifications d’avertissement imminentes de redémarrage automatique. Valeurs prises en charge : 15, 30 ou 60 (minutes). Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| userPauseAccess | Enablement | Spécifie s’il faut autoriser l’accès de l’utilisateur final à suspendre les mises à jour logicielles. Les valeurs possibles sont : NotConfigured, Enabled, Disabled. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont notConfigured, enabled et disabled. |
| userWindowsUpdateScanAccess | Enablement | Spécifie s’il faut désactiver l’accès de l’utilisateur pour analyser Windows Update. Les valeurs possibles sont : NotConfigured, Enabled, Disabled. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont notConfigured, enabled et disabled. |
| updateNotificationLevel | windowsUpdateNotificationDisplayOption | Spécifie ce que Windows Update notifications que les utilisateurs voient. Les valeurs possibles sont : NotConfigured, DefaultNotifications, RestartWarningsOnly, DisableAllNotifications. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont les suivantes : notConfigured, defaultNotifications, restartWarningsOnly, disableAllNotifications, unknownFutureValue. |
| allowWindows11Upgrade | Boolean | Lorsque la valeur est TRUE, autorise la mise à niveau des appareils Windows 10 éligibles vers Windows 11. Si la valeur est FALSE, cela signifie que l’appareil reste sur le système d’exploitation existant. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge. |
Relations
| Relation | Type | Description |
|---|---|---|
| affectations | Collection deviceConfigurationAssignment | Liste des affectations pour le profil de la configuration d’appareil. Hérité de deviceConfiguration. |
| deviceStatuses | Collection deviceConfigurationDeviceStatus | État d’installation de configuration d’appareil par appareil. Hérité de deviceConfiguration. |
| userStatuses | Collection deviceConfigurationUserStatus | Installation de la configuration de l’appareil status par utilisateur. Hérité de deviceConfiguration. |
| deviceStatusOverview | deviceConfigurationDeviceOverview | Vue d’ensemble des statuts d’appareil de configuration d’appareils - Hérité de deviceConfiguration. |
| userStatusOverview | deviceConfigurationUserOverview | Vue d’ensemble des statuts d’utilisateurs de configuration d’appareil- Hérité de deviceConfiguration. |
| deviceSettingStateSummaries | Collection settingStateDeviceSummary | Récapitulatif des états d’appareils de paramètre de configuration- Hérité de deviceConfiguration. |
Représentation JSON
Voici une représentation JSON de la ressource.
{
"@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
}