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
}