Freigeben über


Erstellen 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 erstellt ein neues Objekt des Typs windowsUpdateForBusinessConfiguration.

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

Weltweiter Service 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

POST /deviceManagement/deviceConfigurations

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über 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 Verzögerte Qualität Updates 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 Verzögertes Feature Updates 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 wird quality Updates 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 wird die Feature-Updates nicht angehalten. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.s
qualityUpdatesPauseExpiryDateTime DateTimeOffset Die Quality Updates Anhalten des Ablaufdatumstime. 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 Das Feature Updates Datum und Uhrzeit des Ablaufs anhalten. 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 der Quality Updates Pause. 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 Feature Updates Startdatum anhalten. 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 auf dem nächsten Gerät einchecken. Wenn FALSE festgelegt ist, führen Sie kein Rollback der Qualitäts-Updates beim nächsten Einchecken des Geräts aus. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
featureUpdatesWillBeRolledBack Boolesch Wenn TRUE, rollback Feature Updates auf dem nächsten Gerät einchecken. Wenn FALSE festgelegt ist, führen Sie kein Rollback von Feature-Updates beim nächsten Einchecken des Geräts aus. Wird standardmäßig zurückgegeben. Abfrageparameter werden nicht unterstützt.
qualityUpdatesRollbackStartDateTime DateTimeOffset Die Quality Updates Rollback Start datetime. 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 Das Feature Updates Rollback start datetime. 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 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 201 Created und ein Objekt des Typs windowsUpdateForBusinessConfiguration im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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
}

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 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
}