Share via


Mettre à jour windowsUpdateForBusinessConfiguration

Espace de noms: microsoft.graph

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Met à jour les propriétés d’un objet windowsUpdateForBusinessConfiguration.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) DeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application DeviceManagementConfiguration.ReadWrite.All

Requête HTTP

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet windowsUpdateForBusinessConfiguration.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’objet windowsUpdateForBusinessConfiguration.

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é 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 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é 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ée 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 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 met pas en pause la qualité Mises à jour. 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. Lorsque la valeur est FALSE, ne suspend pas le Mises à jour de fonctionnalité. Renvoyée 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é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 mise en pause Mises à jour 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 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 Valeur booléenne 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 Valeur booléenne 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ée 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ée 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ée 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é 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é 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 Valeur booléenne 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ée par défaut. Les paramètres de requête ne sont pas pris en charge.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet windowsUpdateForBusinessConfiguration mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
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
}

Réponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.

HTTP/1.1 200 OK
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
}