Type de ressource windowsUpdateForBusinessConfiguration

Article
03/26/2023

Espace de noms: microsoft.graph

Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.

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.
action extendFeatureUpdatesPause	Aucune	Étendre la fonctionnalité Mises à jour Suspendre pour un anneau Windows Update entreprise.
action extendQualityUpdatesPause	Aucune	Étendre la qualité Mises à jour Suspendre pour un anneau Windows Update for Business.

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.
roleScopeTagIds	String collection	Liste des balises d’étendue pour cette instance d’entité. Hérité de deviceConfiguration.
supportsScopeTags	Valeur booléenne	Indique si la configuration d’appareil sous-jacente prend en charge l’attribution des balises d’étendue. L’attribution à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et que les entités ne sont pas visibles par les utilisateurs délimités. Cela se produit pour les stratégies héritées créées dans Silverlight et peut être résolu en supprimant et en recréant la stratégie dans le portail Azure. Cette propriété est en lecture seule. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	Applicabilité de l’édition du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	Règle d’applicabilité de la version du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	Règle d’applicabilité du mode appareil pour cette stratégie. 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ée par défaut. Les paramètres de requête ne sont pas pris en charge. Les valeurs possibles sont les suivantes : `userDefined`, `notifyDownload`, `autoInstallAtMaintenanceTime`, `autoInstallAndRebootAtMaintenanceTime`, `autoInstallAndRebootAtScheduledTime`, `autoInstallAndRebootWithoutEndUserControl` et `windowsDefault`.
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 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é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é 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é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, 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é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é 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é par défaut. Les paramètres de requête ne sont pas pris en charge.

Relations

Relation	Type	Description
groupAssignments	collection deviceConfigurationGroupAssignment	Liste des affectations de groupe pour le profil de configuration d’appareil. Hérité de deviceConfiguration.
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)",
  "roleScopeTagIds": [
    "String"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "String"
    ],
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "String",
    "maxOSVersion": "String",
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "String",
    "name": "String",
    "ruleType": "String"
  },
  "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
}