Ringressourcentyp

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.

Ein abstrakter Typ, der den Update-Bereitstellungsring steuert. Ein Update-Bereitstellungsring unterstützt nur Geräte und wird verwendet, um eine Rolloutstrategie für Windows-Updates zu entwickeln. Sie können diese Ressource nicht direkt instanziieren. Verwenden Sie einen der abgeleiteten Typen.

Basistyp von driverUpdateRing, featureUpdateRing und qualityUpdateRing. Instanzen in einer Ring-Auflistung werden durch die @odata.type-Eigenschaft unterschieden, die den abgeleiteten Typ jedes Objekts identifiziert.

Methoden

Methode Rückgabetyp Beschreibung
Ringe auflisten microsoft.graph.windowsUpdates.ring-Sammlung Ruft eine Liste der Ringobjekte und ihrer Eigenschaften ab.
Ring erstellen microsoft.graph.windowsUpdates.ring Erstellen Sie ein neues Ringobjekt .
Ring abrufen microsoft.graph.windowsUpdates.ring Lesen Sie die Eigenschaften und Beziehungen des Ringobjekts .
Updatering microsoft.graph.windowsUpdates.ring Aktualisieren der Eigenschaften eines Ringobjekts .
Ring löschen Keine Löschen eines Ringobjekts .

Eigenschaften

Eigenschaft Typ Beschreibung
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Ring 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. Schreibgeschützt
deferralInDays Int32 Der Update-Zurückstellungszeitraum in Tagen. Der Wert muss zwischen 0 und 30liegen. Optional.
description Zeichenfolge Die Ringbeschreibung. Die maximale Länge beträgt 1.500 Zeichen. Erforderlich
displayName Zeichenfolge Der Anzeigename des Rings. Die maximale Länge beträgt 200 Zeichen. Erforderlich.
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.
id Zeichenfolge Der eindeutige Bezeichner für das Ringobjekt .
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.
isPaused Boolean Die Aktion "Anhalten" für den Updatering. Erforderlich.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung des Rings. 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. Schreibgeschützt.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.windowsUpdates.ring",
  "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"},
  "isPaused": "Boolean",
  "lastModifiedDateTime": "String (timestamp)"
}