Ressourcentyp „windowsUpdateForBusinessConfiguration“
Namespace: microsoft.graph
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Windows Update für die Unternehmenskonfiguration können Sie angeben, wie und wann Windows as a Service Ihre Windows 10/11-Geräte mit Feature- 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 | 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. |
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 | Installation der Gerätekonfiguration status 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
}