Ressourcentyp „windowsUpdateForBusinessConfiguration“
Namespace: microsoft.graph
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Mit der Windows Update for Business-Konfiguration können Sie angeben, wie und wann Windows as a Service Ihre Windows 10/11-Geräte mit Funktions- und Qualitätsupdates aktualisiert. Unterstützt ODATA-Klauseln, die die DeviceConfiguration-Entität unterstützt: $filter nach DeviceConfiguration-Typen, $top, $select nur DeviceConfiguration-Basiseigenschaften, $orderby nur DeviceConfiguration-Basiseigenschaften und $skip. Der Abfrageparameter "$search" wird nicht unterstützt.
Sie erbt von deviceConfiguration.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Auflisten von „windowsUpdateForBusinessConfiguration“ | Sammlung von Objekten des Typs windowsUpdateForBusinessConfiguration | Listet die Eigenschaften und Beziehungen von Objekten des Typs windowsUpdateForBusinessConfiguration auf. |
| Abrufen von „windowsUpdateForBusinessConfiguration“ | windowsUpdateForBusinessConfiguration | Liest die Eigenschaften und Beziehungen von Objekten des Typs windowsUpdateForBusinessConfiguration. |
| Erstellen von „windowsUpdateForBusinessConfiguration“ | windowsUpdateForBusinessConfiguration | Erstellt neue Objekte des Typs windowsUpdateForBusinessConfiguration. |
| Löschen von „windowsUpdateForBusinessConfiguration“ | Keiner | Löscht Objekte des Typs windowsUpdateForBusinessConfiguration. |
| Aktualisieren von „windowsUpdateForBusinessConfiguration“ | windowsUpdateForBusinessConfiguration | Aktualisiert die Eigenschaften von Objekten des Typs windowsUpdateForBusinessConfiguration. |
Eigenschaften
| 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. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| assignments | deviceConfigurationAssignment-Sammlung | Liste der Zuweisungen für das Gerätekonfigurationsprofil. Geerbt von deviceConfiguration. |
| deviceStatuses | deviceConfigurationDeviceStatus-Sammlung | Installationsstatus der Gerätekonfiguration nach Gerät. Geerbt von deviceConfiguration. |
| userStatuses | deviceConfigurationUserStatus-Sammlung | Installationsstatus der Gerätekonfiguration nach Benutzer. Geerbt von deviceConfiguration. |
| deviceStatusOverview | deviceConfigurationDeviceOverview | Übersicht über den Status der Gerätekonfiguration nach Gerät. Geerbt von deviceConfiguration. |
| userStatusOverview | deviceConfigurationUserOverview | Übersicht über den Status der Gerätekonfiguration nach Benutzer. Geerbt von deviceConfiguration. |
| deviceSettingStateSummaries | Sammlung von Objekten des Typs settingStateDeviceSummary | Übersicht über den Einstellungsstatus für die Gerätekonfiguration nach Gerät. Geerbt von deviceConfiguration |
JSON-Darstellung
Es folgt eine JSON-Darstellung der Ressource.
{
"@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"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
}