Type de ressource windowsUpdateForBusinessConfiguration
Espace de noms: microsoft.graph
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
La configuration de 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ée 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é 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é 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 | Valeur booléenne | Lorsque la valeur est TRUE, autorise Microsoft Update Service. Si la valeur est FALSE, n’autorise pas Microsoft Update Service. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| driversExcluded | Valeur booléenne | 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ée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| qualityUpdatesDeferralPeriodInDays | Int32 | Différer les mises à jour qualité 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. |
| featureUpdatesDeferralPeriodInDays | Int32 | Différer les mises à jour des 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 | Valeur booléenne | 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 suspend pas les mises à jour de qualité. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesPaused | Valeur booléenne | 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. Si la valeur est FALSE, ne suspend pas les mises à jour des fonctionnalités. Renvoyé par défaut. Les paramètres de requête ne sont pas pris en charge.s |
| qualityUpdatesPauseExpiryDateTime | DateTimeOffset | La date et heure d’expiration des mises à jour de qualité suspendent. 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 | Les mises à jour des fonctionnalités suspendent la date 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ée 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 | Valeur booléenne | 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ée 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 suspension des mises à jour de qualité. Cette valeur correspond à l’heure à laquelle l’administrateur a suspendu ou prolongé la pause pour l’anneau. Renvoyée 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 suspension des mises à jour des fonctionnalités. Cette valeur correspond à l’heure à laquelle l’administrateur a suspendu ou prolongé la pause pour l’anneau. Renvoyée 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 | Valeur booléenne | Lorsque la valeur est TRUE, restaurez les mises à jour de qualité sur l’appareil suivant. Si la valeur est FALSE, ne restaurez pas les mises à jour qualité sur l’enregistrement suivant de l’appareil. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesWillBeRolledBack | Valeur booléenne | Lorsque la valeur est TRUE, restaurez les mises à jour des fonctionnalités sur l’appareil suivant. Si la valeur est FALSE, ne restaurez pas les mises à jour des fonctionnalités sur l’enregistrement suivant de l’appareil. Retourné par défaut. Les paramètres de requête ne sont pas pris en charge. |
| qualityUpdatesRollbackStartDateTime | DateTimeOffset | Date/heure de début de la restauration des mises à jour de qualité. Cette valeur correspond à l’heure à laquelle l’administrateur a restauré la mise à jour qualité pour l’anneau. Renvoyée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| featureUpdatesRollbackStartDateTime | DateTimeOffset | Date/heure de début de la restauration des mises à jour des fonctionnalités. 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ée 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ée par défaut. Les paramètres de requête ne sont pas pris en charge. |
| postponeRebootUntilAfterDeadline | Valeur booléenne | 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ée 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ée 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ée 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ée 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ée 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 les notifications Windows Update 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 | Valeur booléenne | Si la valeur est TRUE, autorise les appareils Windows 10 éligibles à effectuer une mise à niveau vers Windows 11. Si la valeur est FALSE, cela signifie que l’appareil reste sur le système d’exploitation existant. Renvoyée 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 | État d’installation de la configuration de l’appareil 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
}