Registrieren der Updateverwaltung durch Windows Autopatch

Wenn Sie ein Gerät bei der Updateverwaltung durch Windows Autopatch registrieren, können Sie Windows Autopatch verwenden, um Inhalte zu verwalten, die von Windows Update an dieses Gerät übermittelt werden. Sie können ein Gerät in der Updateverwaltung nach Updatekategorie registrieren.

Windows Autopatch unterstützt heute die Geräteregistrierung für Windows 10/11-Featureupdates und Treiberupdates. Derzeit ist keine Geräteregistrierung bei der Verwaltung von Windows 10/11-Qualitätsupdates erforderlich, um beschleunigte Qualitätsupdates bereitzustellen.

Registrieren des Geräts bei der Updateverwaltung

Wenn Sie ein Gerät bei der Verwaltung für eine bestimmte Updatekategorie registrieren, wird Windows Autopatch zur Autorität für Updates dieser Kategorie, die von Windows Update stammen. Daher erhalten Geräte keine Updates dieser Kategorie von Windows Update, bis Sie ein Update bereitstellen, indem Sie es einer Bereitstellung zuweisen. Geräte werden automatisch registriert, wenn sie durch Windows Autopatch für die Verwaltung registriert werden (d. a. ein azureADDevice-Objekt wird automatisch erstellt, wenn es noch nicht vorhanden ist). Informationen zur Treiberregistrierung finden Sie unter Registrieren von Geräten bei der Treiberverwaltung.

Das folgende Beispiel zeigt, wie Sie ein Gerät bei der Verwaltung von Featureupdates registrieren.

Anforderung

POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/enrollAssets
Content-Type: application/json

{
  "updateCategory": "feature",
  "assets": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    },
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    },
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}

Antwort

HTTP/1.1 202 Accepted

Überprüfen des Registrierungsstatus eines Geräts

Sie können den Registrierungsstatus eines Geräts überprüfen, indem Sie das Gerät abrufen und sich die Registrierungs- und Fehlereigenschaften für das azureADDevice-Objekt ansehen. Ein Gerät, das erfolgreich bei der Updateverwaltung registriert wurde, verfügt über ein updateManagementEnrollment-Objekt in der Enrollments-Auflistung und keine updatableAssetError-Objekte in der errors-Auflistung. Ein Gerät, das versucht hat, sich zu registrieren, aber ein Fehler aufgetreten ist, hat Sammlungen für Registrierungen und Fehler aufgefüllt. Ein Gerät ohne Registrierungsanforderungen verfügt über leere Sammlungen für Registrierungen und Fehler.

Das folgende Beispiel zeigt ein Gerät, das erfolgreich für die Verwaltung von Featureupdates registriert wurde.

Anforderung

GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/983f03cd-03cd-983f-cd03-3f98cd033f98

Antwort

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": {
    "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
    "id": "983f03cd-03cd-983f-cd03-3f98cd033f98",
    "errors": [],
    "enrollments": [
      {
        "@odata.type": "microsoft.graph.windowsUpdates.updateManagementEnrollment",
        "updateCategory": "feature"
      }
    ]
  }
}

Aufheben der Registrierung bei der Verwaltung oder Aufheben der Registrierung

Wenn Sie die Registrierung eines Geräts aus der Verwaltung für eine bestimmte Updatekategorie aufheben, gilt das Gerät nicht mehr als verwaltet und empfängt möglicherweise basierend auf der Richtlinienkonfiguration andere Updates von Windows Update. Das nicht registrierte Gerät wird aus allen Zielgruppen und Bereitstellungen entfernt, die Inhalte für die angegebene Updatekategorie enthalten. Das Gerät bleibt registriert und wird weiterhin registriert und empfängt ggf. Inhalte für andere Updatekategorien.

Anforderung

POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/unenrollAssets
Content-Type: application/json

{
  "updateCategory": "feature",
  "assets": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}

Antwort

HTTP/1.1 202 Accepted

Sie können die Registrierung eines Geräts vollständig aufheben, indem Sie das Geräteobjekt löschen. Wenn die Registrierung eines Geräts aufgehoben wird, wird es automatisch von der Verwaltung für alle Updatekategorien aufgehoben und aus jeder deploymentAudience - und updatableAssetGroup entfernt.

Anforderung

DELETE https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/{azureADDeviceId}

Antwort

HTTP/1.1 202 Accepted