Ressourcentyp „windowsUpdateForBusinessConfiguration“

Artikel
07/07/2022
5 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.

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

Diese Ressource enthält die Windows Update for Business-Konfiguration.

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.
extendFeatureUpdatesPause-Aktion	Keine	Erweitern von Feature Aktualisierungen Pause für einen Windows Update for Business-Ring.
extendQualityUpdatesPause-Aktion	Keine	Erweitern von Quality Aktualisierungen Pause für einen Windows Update for Business-Ring.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Schlüssel der Entität Geerbt von deviceConfiguration.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration.
roleScopeTagIds	String collection	Liste der Bereichstags für diese Entitätsinstanz. Geerbt von deviceConfiguration.
supportsScopeTags	Boolean	Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Das Zuweisen der ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert falsch ist und Entitäten für Benutzer mit Bereich nicht sichtbar sind. Dies gilt für Legacyrichtlinien, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal behoben werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration.
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	Die Anwendbarkeit der Betriebssystemedition für diese Richtlinie. Geerbt von deviceConfiguration.
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	Die Anwendbarkeitsregel für die Betriebssystemversion für diese Richtlinie. Geerbt von deviceConfiguration.
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	Die Gerätemodus-Anwendbarkeitsregel für diese Richtlinie. Geerbt von deviceConfiguration.
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration.
description	Zeichenfolge	Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
displayName	Zeichenfolge	Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
Version	Int32	Version der Gerätekonfiguration. Geerbt von deviceConfiguration.
deliveryOptimizationMode	windowsDeliveryOptimizationMode	Übermittlungsoptimierungsmodus. Mögliche Werte: `userDefined`, `httpOnly`, `httpWithPeeringNat`, `httpWithPeeringPrivateGroup`, `httpWithInternetPeering`, `simpleDownload`, `bypassMode`.
prereleaseFeatures	prereleaseFeatures	Pre-Release-Funktionen. Mögliche Werte sind: `userDefined`, `settingsOnly`, `settingsAndExperimentations` und `notAllowed`.
automaticUpdateMode	automaticUpdateMode	Modus für automatische Updates. Mögliche Werte: `userDefined`, `notifyDownload`, `autoInstallAtMaintenanceTime`, `autoInstallAndRebootAtMaintenanceTime`, `autoInstallAndRebootAtScheduledTime`, `autoInstallAndRebootWithoutEndUserControl`, `windowsDefault`.
microsoftUpdateServiceAllowed	Boolean	Legt fest, dass der Microsoft Update Service zugelassen wird.
driversExcluded	Boolean	Legt fest, dass Treiber von Windows-Updates ausgenommen werden.
installationSchedule	windowsUpdateInstallScheduleType	Installationszeitplan
qualityUpdatesDeferralPeriodInDays	Int32	Legt fest, um wie viele Tage Qualitätsupdates zurückgestellt werden sollen.
featureUpdatesDeferralPeriodInDays	Int32	Legt fest, um wie viele Tage Funktionsupdates zurückgestellt werden sollen.
qualityUpdatesPaused	Boolean	Setzt Qualitätsupdates aus.
featureUpdatesPaused	Boolean	Setzt Funktionsupdates aus.
qualityUpdatesPauseExpiryDateTime	DateTimeOffset	Datum und Uhrzeit des Ablaufs der Aussetzung der Qualitätsupdates
featureUpdatesPauseExpiryDateTime	DateTimeOffset	Datum und Uhrzeit des Ablaufs der Aussetzung der Funktionsupdates
businessReadyUpdatesOnly	windowsUpdateType	Bestimmt, von welchen Branch-Geräten ihre Updates empfangen werden. Mögliche Werte sind: `userDefined`, `all`, `businessReadyOnly`, `windowsInsiderBuildFast`, `windowsInsiderBuildSlow` und `windowsInsiderBuildRelease`.
skipChecksBeforeRestart	Boolean	Legen Sie fest, dass alle Überprüfungen vor dem Neustart übersprungen werden: Akkustand = 40 %, Benutzerpräsenz, Anzeige erforderlich, Präsentationsmodus, Vollbildmodus, Telefonanrufstatus, Spielmodus usw.
updateWeeks	windowsUpdateForBusinessUpdateWeeks	Die Updateinstallation wurde für die Wochen des Monats geplant. Mögliche Werte sind: `userDefined`, `firstWeek`, `secondWeek`, `thirdWeek`, `fourthWeek` und `everyWeek`.
qualityUpdatesPauseStartDate	Datum	Qualität Aktualisierungen Startdatum anhalten. Diese Eigenschaft ist schreibgeschützt.
featureUpdatesPauseStartDate	Datum	Feature Aktualisierungen Startdatum anhalten. Diese Eigenschaft ist schreibgeschützt.
featureUpdatesRollbackWindowInDays	Int32	Die Anzahl der Tage nach einem Featureupdate, für die ein Rollback gültig ist
qualityUpdatesWillBeRolledBack	Boolean	Gibt an, ob beim nächsten Einchecken des Geräts ein Rollback von Quality Aktualisierungen ausgeführt werden soll.
featureUpdatesWillBeRolledBack	Boolean	Gibt an, ob das Feature bei der nächsten Geräteüberprüfung zurückgesetzt Aktualisierungen werden soll.
qualityUpdatesRollbackStartDateTime	DateTimeOffset	Quality Aktualisierungen Rollback Start datetime
featureUpdatesRollbackStartDateTime	DateTimeOffset	Feature Aktualisierungen Rollback Start datetime
engagedRestartDeadlineInDays	Int32	Stichtag in Tagen vor dem automatischen Planen und Ausführen eines ausstehenden Neustarts außerhalb der Nutzungszeit, mit einem gültigen Bereich von 2 bis 30 Tagen
engagedRestartSnoozeScheduleInDays	Int32	Anzahl der Tage, die ein Benutzer erinnerungsbenachrichtigungen über den aktivierten Neustart mit einem gültigen Bereich von 1 bis 3 Tagen erneut erinnern kann
engagedRestartTransitionScheduleInDays	Int32	Anzahl der Tage vor dem Übergang von automatischen Neustarts, die außerhalb der Nutzungszeit geplant sind, in einen engagierten Neustart, der vom Benutzer geplant werden muss, mit einem gültigen Bereich von 0 bis 30 Tagen
deadlineForFeatureUpdatesInDays	Int32	Anzahl der Tage, bevor Featureupdates automatisch mit einem gültigen Bereich von 0 bis 30 Tagen installiert werden
deadlineForQualityUpdatesInDays	Int32	Anzahl der Tage, bevor Qualitätsupdates automatisch mit einem gültigen Bereich von 0 bis 30 Tagen installiert werden
deadlineGracePeriodInDays	Int32	Anzahl der Tage nach Ablauf des Stichtags bis zum automatischen Neustart mit einem gültigen Bereich von 0 bis 7 Tagen
postponeRebootUntilAfterDeadline	Boolean	Gibt an, ob das Gerät bis zum Stichtag für den Neustart außerhalb der Nutzungszeit warten soll.
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` und `user`.
scheduleRestartWarningInHours	Int32	Geben Sie den Zeitraum für Erinnerungsbenachrichtigungen zum automatischen Neustart an. Unterstützte Werte: 2, 4, 8, 12 oder 24 (Stunden).
scheduleImminentRestartWarningInMinutes	Int32	Geben Sie den Zeitraum für bevorstehende Warnungsbenachrichtigungen beim automatischen Neustart an. Unterstützte Werte: 15, 30 oder 60 (Minuten).
userPauseAccess	Aktivierung	Gibt an, ob der Zugriff des Endbenutzers zum Anhalten von Softwareupdates aktiviert werden soll. Mögliche Werte sind: `notConfigured`, `enabled` und `disabled`.
userWindowsUpdateScanAccess	Aktivierung	Gibt an, ob der Zugriff des Benutzers zum Scannen Windows Update deaktiviert werden soll. Mögliche Werte sind: `notConfigured`, `enabled` und `disabled`.
updateNotificationLevel	windowsUpdateNotificationDisplayOption	Gibt an, welche Windows Update Benachrichtigungen Benutzern angezeigt werden. Mögliche Werte: `notConfigured`, `defaultNotifications`, `restartWarningsOnly`, `disableAllNotifications`
allowWindows11Upgrade	Boolean	Berechtigten Windows 10 Geräten das Upgrade auf die neueste Version von Windows 11 erlauben.

Beziehungen

Beziehung	Typ	Beschreibung
groupAssignments	deviceConfigurationGroupAssignment-Sammlung	Die Liste derGruppenzuweisungen für das Gerätekonfigurationsprofil. Geerbt von deviceConfiguration.
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
deviceUpdateStates	windowsUpdateState-Auflistung	Windows Update for Business-Konfigurationsgerätezustände. Diese Sammlung darf maximal 500 Elemente enthalten.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "roleScopeTagIds": [
    "String"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "String"
    ],
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "String",
    "maxOSVersion": "String",
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "String",
    "name": "String",
    "ruleType": "String"
  },
  "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
}

Ressourcentyp „windowsUpdateForBusinessConfiguration“

Methoden

Eigenschaften

Beziehungen

JSON-Darstellung

Feedback