Créer un objet windowsUpdateForBusinessConfiguration
Espace de noms: microsoft.graph
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Crée 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
POST /deviceManagement/deviceConfigurations
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 pour l’objet windowsUpdateForBusinessConfiguration.
Le tableau suivant illustre les propriétés 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é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é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é 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é 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 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é 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é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 | 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é 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é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é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 | 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é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 | 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é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é 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 ce que Windows Update notifications que les utilisateurs voient. Les valeurs possibles sont : NotConfigured, DefaultNotifications, RestartWarningsOnly, DisableAllNotifications. Renvoyé 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. |
Réponse
En cas de réussite, cette méthode renvoie un code de réponse 201 Created
et un objet windowsUpdateForBusinessConfiguration dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
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 201 Created
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
}