featureUpdateRing-Ressourcentyp

Namespace: microsoft.graph.windowsUpdates

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Entität dar, die den Updatebereitstellungsring speziell für Featureupdates steuert. Ein Updatebereitstellungsring unterstützt nur Geräte und wird verwendet, um die Rolloutstrategie für Featureupdates zu phasenweise.

Die Angebotsfenster-Einstellungen des Rings steuern, wie allmählich das Update die Geräte erreicht: offerIntervalInDays bestimmt, wie oft einer neuen Teilmenge von Geräten das Update angeboten wird, und offerDurationInDays legt die Gesamtlänge dieses Rolloutfensters fest. Legen Sie "offerIntervalInDays " fest, um 0 das Update allen Geräten gleichzeitig anzubieten.

Erbt von Ring.

Methoden

Diese Ressource ist Teil einer polymorphen Sammlung, die vom Ringressourcenbasistyp verwaltet wird. Vorgänge werden über die Endpunkte des Basistyps ausgeführt.

Eigenschaften

Eigenschaft Typ Beschreibung
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Ring für Featureupdates erstellt wird. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Geerbt vom Ring.
deferralInDays Int32 Der Zurückstellungszeitraum für Featureupdates in Tagen. Der Wert muss zwischen 0 und 30liegen. Geerbt vom Ring.
description Zeichenfolge Die Beschreibung des Featureupdaterings. Die maximale Länge beträgt 1.500 Zeichen. Geerbt vom Ring.
displayName Zeichenfolge Der Anzeigename des Featureupdaterings. Die maximale Länge beträgt 200 Zeichen. Geerbt vom Ring.
excludedGroupAssignment microsoft.graph.windowsUpdates.excludedGroupAssignment Steuert die Updatebereitstellungszielgruppe mit ausgeschlossenen Gruppen. Gruppen sind logische Container von Geräten, die durch Microsoft Entra-Gruppen dargestellt werden. Geerbt vom Ring.
id Zeichenfolge Der eindeutige Bezeichner für den Featureupdatering. Geerbt vom Ring.
includedGroupAssignment microsoft.graph.windowsUpdates.includedGroupAssignment Steuert die Updatebereitstellungszielgruppe mit eingeschlossenen Gruppen. Gruppen sind logische Container von Geräten, die durch Microsoft Entra-Gruppen dargestellt werden. Geerbt vom Ring.
isOfferOptional Boolean Gibt an, ob das Funktionsupdate Endbenutzern als optional und nicht als erforderlich angeboten wird. Der Standardwert ist false.
isPaused Boolean Stellt die Unterbrechungsaktion für die Richtlinie des Featureupdaterings dar. Geerbt vom Ring.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung des Rings für Featureupdates. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Geerbt vom Ring.
offerDurationInDays Int32 Die Gesamtlänge des Fensters für den stufenweisen Rollout in Tagen vom ersten Angebot des Updates bis zum Abschluss des Rollouts. Das Minimum ist 1. Wird nur verwendet, wenn offerIntervalInDays höher ist 1 ; wird ignoriert, wenn offerIntervalInDays ist 0. Der Standardwert ist 1.
offerIntervalInDays Int32 Gibt an, wie oft (in Tagen) einer neuen Teilmenge von Geräten das Update angeboten wird. Akzeptierter Bereich ist 0 bis 30. Legen Sie diese Einstellung fest, 0 um das Update allen Geräten gleichzeitig anzubieten. Wenn der Wert ist 1 oder höher, wird das Rollout in jedem Intervall um eine Teilmenge fortgesetzt, bis jedem Gerät das Update angeboten wurde. Muss kleiner oder gleich offerDurationInDays sein. Der Standardwert ist 0.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateRing",
  "createdDateTime": "String (timestamp)",
  "deferralInDays": "Int32",
  "description": "String",
  "displayName": "String",
  "excludedGroupAssignment": {"@odata.type": "microsoft.graph.windowsUpdates.excludedGroupAssignment"},
  "id": "String (identifier)",
  "includedGroupAssignment": {"@odata.type": "microsoft.graph.windowsUpdates.includedGroupAssignment"},
  "isOfferOptional": "Boolean",
  "isPaused": "Boolean",
  "lastModifiedDateTime": "String (timestamp)",
  "offerDurationInDays": "Int32",
  "offerIntervalInDays": "Int32"
}