Aktualisieren von „windowsUpdateForBusinessConfiguration“

Namespace: microsoft.graph

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Diese Methode aktualisiert die Eigenschaften von Objekten des Typs windowsUpdateForBusinessConfiguration.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	DeviceManagementConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementConfiguration.ReadWrite.All

HTTP-Anforderung

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Annehmen	application/json

Anforderungstext

Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs windowsUpdateForBusinessConfiguration an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs windowsUpdateForBusinessConfiguration erstellen.

Eigenschaft	Typ	Beschreibung
id	String	Schlüssel der Entität Geerbt von deviceConfiguration.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration.
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration.
description	String	Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
displayName	String	Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
Version	Int32	Version der Gerätekonfiguration. Geerbt von deviceConfiguration.
deliveryOptimizationMode	windowsDeliveryOptimizationMode	Der Übermittlungsoptimierungsmodus. Mögliche Werte sind: UserDefined, HttpOnly, HttpWithPeeringNat, HttpWithPeeringPrivateGroup, HttpWithInternetPeering, SimpleDownload, BypassMode. UserDefined ermöglicht dem Benutzer das Festlegen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte: userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload, bypassMode.
prereleaseFeatures	prereleaseFeatures	Die Vorabversionsfeatures. Mögliche Werte sind: UserDefined, SettingsOnly, SettingsAndExperimentations, NotAllowed. UserDefined ist der Standardwert, keine Absicht. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte: userDefined, settingsOnly, settingsAndExperimentations, notAllowed.
automaticUpdateMode	automaticUpdateMode	Der automatische Updatemodus. Mögliche Werte sind: UserDefined, NotifyDownload, AutoInstallAtMaintenanceTime, AutoInstallAndRebootAtMaintenanceTime, AutoInstallAndRebootAtScheduledTime, AutoInstallAndRebootWithoutEndUserControl, WindowsDefault. UserDefined ist der Standardwert, keine Absicht. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte sind: userDefined, notifyDownload, autoInstallAtMaintenanceTime, autoInstallAndRebootAtMaintenanceTime, autoInstallAndRebootAtScheduledTime und autoInstallAndRebootWithoutEndUserControl.
microsoftUpdateServiceAllowed	Boolesch	Wenn TRUE, lässt Microsoft Update Service zu. Wenn FALSE, lässt Den Microsoft Update-Dienst nicht zu. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
driversExcluded	Boolesch	Bei TRUE schließt Windows Update-Treiber aus. Wenn FALSE, schließt Windows Update-Treiber nicht aus. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
installationSchedule	windowsUpdateInstallScheduleType	Der Installationszeitplan. Mögliche Werte sind: ActiveHoursStart, ActiveHoursEnd, ScheduledInstallDay, ScheduledInstallTime. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
qualityUpdatesDeferralPeriodInDays	Int32	Verschiebt Qualitätsupdates um diese vielen Tage mit einem gültigen Bereich von 0 bis 30 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
featureUpdatesDeferralPeriodInDays	Int32	Verschiebt Featureupdates um diese vielen Tage mit einem gültigen Bereich von 0 bis 30 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
qualityUpdatesPaused	Boolesch	Bei TRUE werden zugewiesene Geräte bis zu 35 Tage lang angehalten, qualitätsrelevante Updates zu erhalten, nachdem Sie den Ring angehalten haben. Bei FALSE werden Qualitätsupdates nicht angehalten. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
featureUpdatesPaused	Boolesch	Bei TRUE werden zugewiesene Geräte bis zu 35 Tage lang vom Empfang von Featureupdates ab dem Zeitpunkt angehalten, an dem Sie den Ring anhalten. Bei FALSE werden Featureupdates nicht angehalten. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.s
qualityUpdatesPauseExpiryDateTime	DateTimeOffset	Das Datum für das Anhalten von Qualitätsupdates für ablaufende Datum/Uhrzeit. Dieser Wert beträgt 35 Tage ab dem Zeitpunkt, zu dem der Administrator die Pause für den Ring angehalten oder verlängert hat. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
featureUpdatesPauseExpiryDateTime	DateTimeOffset	Die Featureupdates anhalten ablaufdatumtime. Dieser Wert beträgt 35 Tage ab dem Zeitpunkt, zu dem der Administrator die Pause für den Ring angehalten oder verlängert hat. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
businessReadyUpdatesOnly	windowsUpdateType	Bestimmt, von welchen Branchgeräten updates empfangen werden. Mögliche Werte sind: UserDefined, All, BusinessReadyOnly, WindowsInsiderBuildFast, WindowsInsiderBuildSlow, WindowsInsiderBuildRelease. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte sind: userDefined, all, businessReadyOnly, windowsInsiderBuildFast, windowsInsiderBuildSlow und windowsInsiderBuildRelease.
skipChecksBeforeRestart	Boolesch	Bei TRUE überspringt alle Überprüfungen vor dem Neustart: Akkustand = 40 %, Benutzerpräsenz, Anzeige erforderlich, Präsentationsmodus, Vollbildmodus, Telefonanrufstatus, Spielmodus usw. Bei FALSE überspringt nicht alle Überprüfungen vor dem Neustart. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
updateWeeks	windowsUpdateForBusinessUpdateWeeks	Planen Sie die Updateinstallation für die Wochen des Monats. Mögliche Werte sind: UserDefined, FirstWeek, SecondWeek, ThirdWeek, FourthWeek, EveryWeek. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte: userDefined, firstWeek, secondWeek, thirdWeek, fourthWeek, everyWeek, unknownFutureValue.
qualityUpdatesPauseStartDate	Datum	Das Startdatum für das Anhalten von Qualitätsupdates. Dieser Wert ist der Zeitpunkt, zu dem der Administrator die Pause für den Ring angehalten oder verlängert hat. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Diese Eigenschaft ist schreibgeschützt.
featureUpdatesPauseStartDate	Datum	Das Startdatum der Featureupdatepause. Dieser Wert ist der Zeitpunkt, zu dem der Administrator die Pause für den Ring angehalten oder verlängert hat. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Diese Eigenschaft ist schreibgeschützt.
featureUpdatesRollbackWindowInDays	Int32	Die Anzahl der Tage nach einem Featureupdate, für die ein Rollback gültig ist, mit einem gültigen Bereich von 2 bis 60 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
qualityUpdatesWillBeRolledBack	Boolesch	Wenn TRUE, rollback Quality Updates on the next device check in. Wenn FALSE festgelegt ist, führen Sie beim nächsten Einchecken des Geräts kein Rollback für Qualitätsupdates aus. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
featureUpdatesWillBeRolledBack	Boolesch	Wenn TRUE, rollback Featureupdates auf dem nächsten Gerät einchecken. Wenn FALSE festgelegt ist, führen Sie beim nächsten Einchecken des Geräts kein Rollback für Featureupdates aus. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
qualityUpdatesRollbackStartDateTime	DateTimeOffset	Das Startdatum des Rollbacks für Qualitätsupdates. Dieser Wert ist der Zeitpunkt, zu dem der Administrator ein Rollback für das Qualitätsupdate für den Ring ausgeführt hat. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
featureUpdatesRollbackStartDateTime	DateTimeOffset	Der Rollback für Featureupdates starttime. Dieser Wert ist der Zeitpunkt, zu dem der Administrator ein Rollback für das Featureupdate für den Ring ausgeführt hat. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
engagedRestartDeadlineInDays	Int32	Stichtag in Tagen vor der automatischen Planung und Ausführung eines ausstehenden Neustarts außerhalb der aktiven Stunden mit einem gültigen Bereich von 2 bis 30 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
engagedRestartSnoozeScheduleInDays	Int32	Die Anzahl der Tage, an denen ein Benutzer erinnerungsbenachrichtigungen für den engagierten Neustart zurücksen kann und einen gültigen Bereich von 1 bis 3 Tagen hat. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
engagedRestartTransitionScheduleInDays	Int32	Anzahl der Tage vor dem Übergang von "Automatische Neustarts", die außerhalb der aktiven Stunden geplant sind, zu "Aktiver Neustart", der vom Benutzer geplant werden muss, mit einem gültigen Bereich von 0 bis 30 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
deadlineForFeatureUpdatesInDays	Int32	Die Anzahl der Tage, bevor Featureupdates automatisch installiert werden, mit einem gültigen Bereich von 0 bis 30 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
deadlineForQualityUpdatesInDays	Int32	Die Anzahl der Tage, bevor Qualitätsupdates automatisch installiert werden, mit einem gültigen Bereich von 0 bis 30 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
deadlineGracePeriodInDays	Int32	Anzahl der Tage nach Ablauf der Frist bis zum automatischen Neustart mit einem gültigen Bereich von 0 bis 7 Tagen. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
postponeRebootUntilAfterDeadline	Boolesch	Bei TRUE sollte das Gerät bis zum Stichtag für den Neustart außerhalb der Geschäftszeiten warten. Bei FALSE sollte das Gerät nicht bis zum Stichtag für den Neustart außerhalb der Geschäftszeiten warten. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
autoRestartNotificationDismissal	autoRestartNotificationDismissalMethod	Geben Sie die Methode an, mit der die erforderliche Benachrichtigung für den automatischen Neustart geschlossen wird. Mögliche Werte sind: NotConfigured, Automatic, User. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte: notConfigured, automatic, user, unknownFutureValue
scheduleRestartWarningInHours	Int32	Geben Sie den Zeitraum für Warnungsbenachrichtigungen zum automatischen Neustart an. Unterstützte Werte: 2, 4, 8, 12 oder 24 (Stunden). Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
scheduleImminentRestartWarningInMinutes	Int32	Geben Sie den Zeitraum für warnungsbenachrichtigungen für den automatischen Neustart an. Unterstützte Werte: 15, 30 oder 60 (Minuten). Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
userPauseAccess	Ermöglichen	Gibt an, ob der Zugriff des Endbenutzers zum Anhalten von Softwareupdates aktiviert werden soll. Mögliche Werte sind: NotConfigured, Enabled, Disabled. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte sind: notConfigured, enabled und disabled.
userWindowsUpdateScanAccess	Ermöglichen	Gibt an, ob der Zugriff des Benutzers zum Überprüfen von Windows Update deaktiviert werden soll. Mögliche Werte sind: NotConfigured, Enabled, Disabled. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte sind: notConfigured, enabled und disabled.
updateNotificationLevel	windowsUpdateNotificationDisplayOption	Gibt an, welche Windows Update-Benachrichtigungen Benutzern angezeigt werden. Mögliche Werte sind: NotConfigured, DefaultNotifications, RestartWarningsOnly, DisableAllNotifications. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt. Mögliche Werte: notConfigured, defaultNotifications, restartWarningsOnly, disableAllNotifications, unknownFutureValue.
allowWindows11Upgrade	Boolesch	Bei TRUE können berechtigte Windows 10-Geräte ein Upgrade auf Windows 11 durchführen. False bedeutet, dass das Gerät auf dem vorhandenen Betriebssystem verbleibt. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 OK und ein aktualisiertes Objekt des Typs windowsUpdateForBusinessConfiguration im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

HTTP

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
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new WindowsUpdateForBusinessConfiguration
{
	OdataType = "#microsoft.graph.windowsUpdateForBusinessConfiguration",
	Description = "Description value",
	DisplayName = "Display Name value",
	Version = 7,
	DeliveryOptimizationMode = WindowsDeliveryOptimizationMode.HttpOnly,
	PrereleaseFeatures = PrereleaseFeatures.SettingsOnly,
	AutomaticUpdateMode = AutomaticUpdateMode.NotifyDownload,
	MicrosoftUpdateServiceAllowed = true,
	DriversExcluded = true,
	InstallationSchedule = new WindowsUpdateScheduledInstall
	{
		OdataType = "microsoft.graph.windowsUpdateScheduledInstall",
		ScheduledInstallDay = WeeklySchedule.Everyday,
		ScheduledInstallTime = new Time(DateTime.Parse("11:59:31.3170000")),
	},
	QualityUpdatesDeferralPeriodInDays = 2,
	FeatureUpdatesDeferralPeriodInDays = 2,
	QualityUpdatesPaused = true,
	FeatureUpdatesPaused = true,
	QualityUpdatesPauseExpiryDateTime = DateTimeOffset.Parse("2017-01-01T00:00:22.9594683-08:00"),
	FeatureUpdatesPauseExpiryDateTime = DateTimeOffset.Parse("2016-12-31T23:58:08.068669-08:00"),
	BusinessReadyUpdatesOnly = WindowsUpdateType.All,
	SkipChecksBeforeRestart = true,
	UpdateWeeks = WindowsUpdateForBusinessUpdateWeeks.FirstWeek,
	QualityUpdatesPauseStartDate = new Date(DateTime.Parse("2016-12-31")),
	FeatureUpdatesPauseStartDate = new Date(DateTime.Parse("2016-12-31")),
	FeatureUpdatesRollbackWindowInDays = 2,
	QualityUpdatesWillBeRolledBack = true,
	FeatureUpdatesWillBeRolledBack = true,
	QualityUpdatesRollbackStartDateTime = DateTimeOffset.Parse("2016-12-31T23:57:01.05526-08:00"),
	FeatureUpdatesRollbackStartDateTime = DateTimeOffset.Parse("2017-01-01T00:03:21.6080517-08:00"),
	EngagedRestartDeadlineInDays = 12,
	EngagedRestartSnoozeScheduleInDays = 2,
	EngagedRestartTransitionScheduleInDays = 6,
	DeadlineForFeatureUpdatesInDays = 15,
	DeadlineForQualityUpdatesInDays = 15,
	DeadlineGracePeriodInDays = 9,
	PostponeRebootUntilAfterDeadline = true,
	AutoRestartNotificationDismissal = AutoRestartNotificationDismissalMethod.Automatic,
	ScheduleRestartWarningInHours = 13,
	ScheduleImminentRestartWarningInMinutes = 7,
	UserPauseAccess = Enablement.Enabled,
	UserWindowsUpdateScanAccess = Enablement.Enabled,
	UpdateNotificationLevel = WindowsUpdateNotificationDisplayOption.DefaultNotifications,
	AllowWindows11Upgrade = true,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.DeviceConfigurations["{deviceConfiguration-id}"].PatchAsync(requestBody);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

CLI

mgc device-management device-configurations patch --device-configuration-id {deviceConfiguration-id} --body '{\
  "@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\
}\
'

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Go

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  "time"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewDeviceConfiguration()
description := "Description value"
requestBody.SetDescription(&description) 
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 
version := int32(7)
requestBody.SetVersion(&version) 
deliveryOptimizationMode := graphmodels.HTTPONLY_WINDOWSDELIVERYOPTIMIZATIONMODE 
requestBody.SetDeliveryOptimizationMode(&deliveryOptimizationMode) 
prereleaseFeatures := graphmodels.SETTINGSONLY_PRERELEASEFEATURES 
requestBody.SetPrereleaseFeatures(&prereleaseFeatures) 
automaticUpdateMode := graphmodels.NOTIFYDOWNLOAD_AUTOMATICUPDATEMODE 
requestBody.SetAutomaticUpdateMode(&automaticUpdateMode) 
microsoftUpdateServiceAllowed := true
requestBody.SetMicrosoftUpdateServiceAllowed(&microsoftUpdateServiceAllowed) 
driversExcluded := true
requestBody.SetDriversExcluded(&driversExcluded) 
installationSchedule := graphmodels.NewWindowsUpdateScheduledInstall()
scheduledInstallDay := graphmodels.EVERYDAY_WEEKLYSCHEDULE 
installationSchedule.SetScheduledInstallDay(&scheduledInstallDay) 
scheduledInstallTime := 11:59:31.3170000
installationSchedule.SetScheduledInstallTime(&scheduledInstallTime) 
requestBody.SetInstallationSchedule(installationSchedule)
qualityUpdatesDeferralPeriodInDays := int32(2)
requestBody.SetQualityUpdatesDeferralPeriodInDays(&qualityUpdatesDeferralPeriodInDays) 
featureUpdatesDeferralPeriodInDays := int32(2)
requestBody.SetFeatureUpdatesDeferralPeriodInDays(&featureUpdatesDeferralPeriodInDays) 
qualityUpdatesPaused := true
requestBody.SetQualityUpdatesPaused(&qualityUpdatesPaused) 
featureUpdatesPaused := true
requestBody.SetFeatureUpdatesPaused(&featureUpdatesPaused) 
qualityUpdatesPauseExpiryDateTime , err := time.Parse(time.RFC3339, "2017-01-01T00:00:22.9594683-08:00")
requestBody.SetQualityUpdatesPauseExpiryDateTime(&qualityUpdatesPauseExpiryDateTime) 
featureUpdatesPauseExpiryDateTime , err := time.Parse(time.RFC3339, "2016-12-31T23:58:08.068669-08:00")
requestBody.SetFeatureUpdatesPauseExpiryDateTime(&featureUpdatesPauseExpiryDateTime) 
businessReadyUpdatesOnly := graphmodels.ALL_WINDOWSUPDATETYPE 
requestBody.SetBusinessReadyUpdatesOnly(&businessReadyUpdatesOnly) 
skipChecksBeforeRestart := true
requestBody.SetSkipChecksBeforeRestart(&skipChecksBeforeRestart) 
updateWeeks := graphmodels.FIRSTWEEK_WINDOWSUPDATEFORBUSINESSUPDATEWEEKS 
requestBody.SetUpdateWeeks(&updateWeeks) 
qualityUpdatesPauseStartDate := 2016-12-31
requestBody.SetQualityUpdatesPauseStartDate(&qualityUpdatesPauseStartDate) 
featureUpdatesPauseStartDate := 2016-12-31
requestBody.SetFeatureUpdatesPauseStartDate(&featureUpdatesPauseStartDate) 
featureUpdatesRollbackWindowInDays := int32(2)
requestBody.SetFeatureUpdatesRollbackWindowInDays(&featureUpdatesRollbackWindowInDays) 
qualityUpdatesWillBeRolledBack := true
requestBody.SetQualityUpdatesWillBeRolledBack(&qualityUpdatesWillBeRolledBack) 
featureUpdatesWillBeRolledBack := true
requestBody.SetFeatureUpdatesWillBeRolledBack(&featureUpdatesWillBeRolledBack) 
qualityUpdatesRollbackStartDateTime , err := time.Parse(time.RFC3339, "2016-12-31T23:57:01.05526-08:00")
requestBody.SetQualityUpdatesRollbackStartDateTime(&qualityUpdatesRollbackStartDateTime) 
featureUpdatesRollbackStartDateTime , err := time.Parse(time.RFC3339, "2017-01-01T00:03:21.6080517-08:00")
requestBody.SetFeatureUpdatesRollbackStartDateTime(&featureUpdatesRollbackStartDateTime) 
engagedRestartDeadlineInDays := int32(12)
requestBody.SetEngagedRestartDeadlineInDays(&engagedRestartDeadlineInDays) 
engagedRestartSnoozeScheduleInDays := int32(2)
requestBody.SetEngagedRestartSnoozeScheduleInDays(&engagedRestartSnoozeScheduleInDays) 
engagedRestartTransitionScheduleInDays := int32(6)
requestBody.SetEngagedRestartTransitionScheduleInDays(&engagedRestartTransitionScheduleInDays) 
deadlineForFeatureUpdatesInDays := int32(15)
requestBody.SetDeadlineForFeatureUpdatesInDays(&deadlineForFeatureUpdatesInDays) 
deadlineForQualityUpdatesInDays := int32(15)
requestBody.SetDeadlineForQualityUpdatesInDays(&deadlineForQualityUpdatesInDays) 
deadlineGracePeriodInDays := int32(9)
requestBody.SetDeadlineGracePeriodInDays(&deadlineGracePeriodInDays) 
postponeRebootUntilAfterDeadline := true
requestBody.SetPostponeRebootUntilAfterDeadline(&postponeRebootUntilAfterDeadline) 
autoRestartNotificationDismissal := graphmodels.AUTOMATIC_AUTORESTARTNOTIFICATIONDISMISSALMETHOD 
requestBody.SetAutoRestartNotificationDismissal(&autoRestartNotificationDismissal) 
scheduleRestartWarningInHours := int32(13)
requestBody.SetScheduleRestartWarningInHours(&scheduleRestartWarningInHours) 
scheduleImminentRestartWarningInMinutes := int32(7)
requestBody.SetScheduleImminentRestartWarningInMinutes(&scheduleImminentRestartWarningInMinutes) 
userPauseAccess := graphmodels.ENABLED_ENABLEMENT 
requestBody.SetUserPauseAccess(&userPauseAccess) 
userWindowsUpdateScanAccess := graphmodels.ENABLED_ENABLEMENT 
requestBody.SetUserWindowsUpdateScanAccess(&userWindowsUpdateScanAccess) 
updateNotificationLevel := graphmodels.DEFAULTNOTIFICATIONS_WINDOWSUPDATENOTIFICATIONDISPLAYOPTION 
requestBody.SetUpdateNotificationLevel(&updateNotificationLevel) 
allowWindows11Upgrade := true
requestBody.SetAllowWindows11Upgrade(&allowWindows11Upgrade) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
deviceConfigurations, err := graphClient.DeviceManagement().DeviceConfigurations().ByDeviceConfigurationId("deviceConfiguration-id").Patch(context.Background(), requestBody, nil)

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

WindowsUpdateForBusinessConfiguration deviceConfiguration = new WindowsUpdateForBusinessConfiguration();
deviceConfiguration.setOdataType("#microsoft.graph.windowsUpdateForBusinessConfiguration");
deviceConfiguration.setDescription("Description value");
deviceConfiguration.setDisplayName("Display Name value");
deviceConfiguration.setVersion(7);
deviceConfiguration.setDeliveryOptimizationMode(WindowsDeliveryOptimizationMode.HttpOnly);
deviceConfiguration.setPrereleaseFeatures(PrereleaseFeatures.SettingsOnly);
deviceConfiguration.setAutomaticUpdateMode(AutomaticUpdateMode.NotifyDownload);
deviceConfiguration.setMicrosoftUpdateServiceAllowed(true);
deviceConfiguration.setDriversExcluded(true);
WindowsUpdateScheduledInstall installationSchedule = new WindowsUpdateScheduledInstall();
installationSchedule.setOdataType("microsoft.graph.windowsUpdateScheduledInstall");
installationSchedule.setScheduledInstallDay(WeeklySchedule.Everyday);
LocalTime scheduledInstallTime = LocalTime.parse("11:59:31.3170000");
installationSchedule.setScheduledInstallTime(scheduledInstallTime);
deviceConfiguration.setInstallationSchedule(installationSchedule);
deviceConfiguration.setQualityUpdatesDeferralPeriodInDays(2);
deviceConfiguration.setFeatureUpdatesDeferralPeriodInDays(2);
deviceConfiguration.setQualityUpdatesPaused(true);
deviceConfiguration.setFeatureUpdatesPaused(true);
OffsetDateTime qualityUpdatesPauseExpiryDateTime = OffsetDateTime.parse("2017-01-01T00:00:22.9594683-08:00");
deviceConfiguration.setQualityUpdatesPauseExpiryDateTime(qualityUpdatesPauseExpiryDateTime);
OffsetDateTime featureUpdatesPauseExpiryDateTime = OffsetDateTime.parse("2016-12-31T23:58:08.068669-08:00");
deviceConfiguration.setFeatureUpdatesPauseExpiryDateTime(featureUpdatesPauseExpiryDateTime);
deviceConfiguration.setBusinessReadyUpdatesOnly(WindowsUpdateType.All);
deviceConfiguration.setSkipChecksBeforeRestart(true);
deviceConfiguration.setUpdateWeeks(EnumSet.of(WindowsUpdateForBusinessUpdateWeeks.FirstWeek));
LocalDate qualityUpdatesPauseStartDate = LocalDate.parse("2016-12-31");
deviceConfiguration.setQualityUpdatesPauseStartDate(qualityUpdatesPauseStartDate);
LocalDate featureUpdatesPauseStartDate = LocalDate.parse("2016-12-31");
deviceConfiguration.setFeatureUpdatesPauseStartDate(featureUpdatesPauseStartDate);
deviceConfiguration.setFeatureUpdatesRollbackWindowInDays(2);
deviceConfiguration.setQualityUpdatesWillBeRolledBack(true);
deviceConfiguration.setFeatureUpdatesWillBeRolledBack(true);
OffsetDateTime qualityUpdatesRollbackStartDateTime = OffsetDateTime.parse("2016-12-31T23:57:01.05526-08:00");
deviceConfiguration.setQualityUpdatesRollbackStartDateTime(qualityUpdatesRollbackStartDateTime);
OffsetDateTime featureUpdatesRollbackStartDateTime = OffsetDateTime.parse("2017-01-01T00:03:21.6080517-08:00");
deviceConfiguration.setFeatureUpdatesRollbackStartDateTime(featureUpdatesRollbackStartDateTime);
deviceConfiguration.setEngagedRestartDeadlineInDays(12);
deviceConfiguration.setEngagedRestartSnoozeScheduleInDays(2);
deviceConfiguration.setEngagedRestartTransitionScheduleInDays(6);
deviceConfiguration.setDeadlineForFeatureUpdatesInDays(15);
deviceConfiguration.setDeadlineForQualityUpdatesInDays(15);
deviceConfiguration.setDeadlineGracePeriodInDays(9);
deviceConfiguration.setPostponeRebootUntilAfterDeadline(true);
deviceConfiguration.setAutoRestartNotificationDismissal(AutoRestartNotificationDismissalMethod.Automatic);
deviceConfiguration.setScheduleRestartWarningInHours(13);
deviceConfiguration.setScheduleImminentRestartWarningInMinutes(7);
deviceConfiguration.setUserPauseAccess(Enablement.Enabled);
deviceConfiguration.setUserWindowsUpdateScanAccess(Enablement.Enabled);
deviceConfiguration.setUpdateNotificationLevel(WindowsUpdateNotificationDisplayOption.DefaultNotifications);
deviceConfiguration.setAllowWindows11Upgrade(true);
DeviceConfiguration result = graphClient.deviceManagement().deviceConfigurations().byDeviceConfigurationId("{deviceConfiguration-id}").patch(deviceConfiguration);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const deviceConfiguration = {
  '@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
};

await client.api('/deviceManagement/deviceConfigurations/{deviceConfigurationId}')
	.update(deviceConfiguration);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\WindowsUpdateForBusinessConfiguration;
use Microsoft\Graph\Generated\Models\WindowsDeliveryOptimizationMode;
use Microsoft\Graph\Generated\Models\PrereleaseFeatures;
use Microsoft\Graph\Generated\Models\AutomaticUpdateMode;
use Microsoft\Graph\Generated\Models\WindowsUpdateScheduledInstall;
use Microsoft\Graph\Generated\Models\WeeklySchedule;
use Microsoft\Kiota\Abstractions\Types\Time;
use Microsoft\Graph\Generated\Models\WindowsUpdateType;
use Microsoft\Graph\Generated\Models\WindowsUpdateForBusinessUpdateWeeks;
use Microsoft\Kiota\Abstractions\Types\Date;
use Microsoft\Graph\Generated\Models\AutoRestartNotificationDismissalMethod;
use Microsoft\Graph\Generated\Models\Enablement;
use Microsoft\Graph\Generated\Models\WindowsUpdateNotificationDisplayOption;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new WindowsUpdateForBusinessConfiguration();
$requestBody->setOdataType('#microsoft.graph.windowsUpdateForBusinessConfiguration');
$requestBody->setDescription('Description value');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion(7);
$requestBody->setDeliveryOptimizationMode(new WindowsDeliveryOptimizationMode('httpOnly'));
$requestBody->setPrereleaseFeatures(new PrereleaseFeatures('settingsOnly'));
$requestBody->setAutomaticUpdateMode(new AutomaticUpdateMode('notifyDownload'));
$requestBody->setMicrosoftUpdateServiceAllowed(true);
$requestBody->setDriversExcluded(true);
$installationSchedule = new WindowsUpdateScheduledInstall();
$installationSchedule->setOdataType('microsoft.graph.windowsUpdateScheduledInstall');
$installationSchedule->setScheduledInstallDay(new WeeklySchedule('everyday'));
$installationSchedule->setScheduledInstallTime(new Time('11:59:31.3170000'));
$requestBody->setInstallationSchedule($installationSchedule);
$requestBody->setQualityUpdatesDeferralPeriodInDays(2);
$requestBody->setFeatureUpdatesDeferralPeriodInDays(2);
$requestBody->setQualityUpdatesPaused(true);
$requestBody->setFeatureUpdatesPaused(true);
$requestBody->setQualityUpdatesPauseExpiryDateTime(new \DateTime('2017-01-01T00:00:22.9594683-08:00'));
$requestBody->setFeatureUpdatesPauseExpiryDateTime(new \DateTime('2016-12-31T23:58:08.068669-08:00'));
$requestBody->setBusinessReadyUpdatesOnly(new WindowsUpdateType('all'));
$requestBody->setSkipChecksBeforeRestart(true);
$requestBody->setUpdateWeeks(new WindowsUpdateForBusinessUpdateWeeks('firstWeek'));
$requestBody->setQualityUpdatesPauseStartDate(new Date('2016-12-31'));
$requestBody->setFeatureUpdatesPauseStartDate(new Date('2016-12-31'));
$requestBody->setFeatureUpdatesRollbackWindowInDays(2);
$requestBody->setQualityUpdatesWillBeRolledBack(true);
$requestBody->setFeatureUpdatesWillBeRolledBack(true);
$requestBody->setQualityUpdatesRollbackStartDateTime(new \DateTime('2016-12-31T23:57:01.05526-08:00'));
$requestBody->setFeatureUpdatesRollbackStartDateTime(new \DateTime('2017-01-01T00:03:21.6080517-08:00'));
$requestBody->setEngagedRestartDeadlineInDays(12);
$requestBody->setEngagedRestartSnoozeScheduleInDays(2);
$requestBody->setEngagedRestartTransitionScheduleInDays(6);
$requestBody->setDeadlineForFeatureUpdatesInDays(15);
$requestBody->setDeadlineForQualityUpdatesInDays(15);
$requestBody->setDeadlineGracePeriodInDays(9);
$requestBody->setPostponeRebootUntilAfterDeadline(true);
$requestBody->setAutoRestartNotificationDismissal(new AutoRestartNotificationDismissalMethod('automatic'));
$requestBody->setScheduleRestartWarningInHours(13);
$requestBody->setScheduleImminentRestartWarningInMinutes(7);
$requestBody->setUserPauseAccess(new Enablement('enabled'));
$requestBody->setUserWindowsUpdateScanAccess(new Enablement('enabled'));
$requestBody->setUpdateNotificationLevel(new WindowsUpdateNotificationDisplayOption('defaultNotifications'));
$requestBody->setAllowWindows11Upgrade(true);

$result = $graphServiceClient->deviceManagement()->deviceConfigurations()->byDeviceConfigurationId('deviceConfiguration-id')->patch($requestBody)->wait();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.DeviceManagement

$params = @{
	"@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 = 
	featureUpdatesDeferralPeriodInDays = 
	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 = 
	qualityUpdatesWillBeRolledBack = $true
	featureUpdatesWillBeRolledBack = $true
	qualityUpdatesRollbackStartDateTime = "2016-12-31T23:57:01.05526-08:00"
	featureUpdatesRollbackStartDateTime = "2017-01-01T00:03:21.6080517-08:00"
	engagedRestartDeadlineInDays = 
	engagedRestartSnoozeScheduleInDays = 
	engagedRestartTransitionScheduleInDays = 
	deadlineForFeatureUpdatesInDays = 
	deadlineForQualityUpdatesInDays = 
	deadlineGracePeriodInDays = 
	postponeRebootUntilAfterDeadline = $true
	autoRestartNotificationDismissal = "automatic"
	scheduleRestartWarningInHours = 
	scheduleImminentRestartWarningInMinutes = 
	userPauseAccess = "enabled"
	userWindowsUpdateScanAccess = "enabled"
	updateNotificationLevel = "defaultNotifications"
	allowWindows11Upgrade = $true
}

Update-MgDeviceManagementDeviceConfiguration -DeviceConfigurationId $deviceConfigurationId -BodyParameter $params

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.windows_update_for_business_configuration import WindowsUpdateForBusinessConfiguration
from msgraph.generated.models.windows_delivery_optimization_mode import WindowsDeliveryOptimizationMode
from msgraph.generated.models.prerelease_features import PrereleaseFeatures
from msgraph.generated.models.automatic_update_mode import AutomaticUpdateMode
from msgraph.generated.models.windows_update_scheduled_install import WindowsUpdateScheduledInstall
from msgraph.generated.models.weekly_schedule import WeeklySchedule
from msgraph.generated.models.windows_update_type import WindowsUpdateType
from msgraph.generated.models.windows_update_for_business_update_weeks import WindowsUpdateForBusinessUpdateWeeks
from msgraph.generated.models.auto_restart_notification_dismissal_method import AutoRestartNotificationDismissalMethod
from msgraph.generated.models.enablement import Enablement
from msgraph.generated.models.windows_update_notification_display_option import WindowsUpdateNotificationDisplayOption
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = WindowsUpdateForBusinessConfiguration(
	odata_type = "#microsoft.graph.windowsUpdateForBusinessConfiguration",
	description = "Description value",
	display_name = "Display Name value",
	version = 7,
	delivery_optimization_mode = WindowsDeliveryOptimizationMode.HttpOnly,
	prerelease_features = PrereleaseFeatures.SettingsOnly,
	automatic_update_mode = AutomaticUpdateMode.NotifyDownload,
	microsoft_update_service_allowed = True,
	drivers_excluded = True,
	installation_schedule = WindowsUpdateScheduledInstall(
		odata_type = "microsoft.graph.windowsUpdateScheduledInstall",
		scheduled_install_day = WeeklySchedule.Everyday,
		scheduled_install_time = "11:59:31.3170000",
	),
	quality_updates_deferral_period_in_days = 2,
	feature_updates_deferral_period_in_days = 2,
	quality_updates_paused = True,
	feature_updates_paused = True,
	quality_updates_pause_expiry_date_time = "2017-01-01T00:00:22.9594683-08:00",
	feature_updates_pause_expiry_date_time = "2016-12-31T23:58:08.068669-08:00",
	business_ready_updates_only = WindowsUpdateType.All,
	skip_checks_before_restart = True,
	update_weeks = WindowsUpdateForBusinessUpdateWeeks.FirstWeek,
	quality_updates_pause_start_date = "2016-12-31",
	feature_updates_pause_start_date = "2016-12-31",
	feature_updates_rollback_window_in_days = 2,
	quality_updates_will_be_rolled_back = True,
	feature_updates_will_be_rolled_back = True,
	quality_updates_rollback_start_date_time = "2016-12-31T23:57:01.05526-08:00",
	feature_updates_rollback_start_date_time = "2017-01-01T00:03:21.6080517-08:00",
	engaged_restart_deadline_in_days = 12,
	engaged_restart_snooze_schedule_in_days = 2,
	engaged_restart_transition_schedule_in_days = 6,
	deadline_for_feature_updates_in_days = 15,
	deadline_for_quality_updates_in_days = 15,
	deadline_grace_period_in_days = 9,
	postpone_reboot_until_after_deadline = True,
	auto_restart_notification_dismissal = AutoRestartNotificationDismissalMethod.Automatic,
	schedule_restart_warning_in_hours = 13,
	schedule_imminent_restart_warning_in_minutes = 7,
	user_pause_access = Enablement.Enabled,
	user_windows_update_scan_access = Enablement.Enabled,
	update_notification_level = WindowsUpdateNotificationDisplayOption.DefaultNotifications,
	allow_windows11_upgrade = True,
)

result = await graph_client.device_management.device_configurations.by_device_configuration_id('deviceConfiguration-id').patch(request_body)

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

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
}