Registrieren der Updateverwaltung durch den Windows Update for Business-Bereitstellungsdienst

Wenn Sie ein Gerät bei der Updateverwaltung durch den Windows Update for Business-Bereitstellungsdienst registrieren, können Sie den Bereitstellungsdienst 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.

Heute unterstützt der Bereitstellungsdienst die Registrierung bei der Verwaltung von Windows 10/11-Featureupdates und Treiberupdates. Derzeit erfordert der Bereitstellungsdienst keine Registrierung bei der Verwaltung von Windows 10/11-Qualitätsupdates, 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 der Bereitstellungsdienst 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 mithilfe des Bereitstellungsdiensts bereitstellen, indem Sie es einer Bereitstellung zuweisen. Geräte werden automatisch beim Dienst registriert, wenn sie durch den Dienst 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, auf dem der Dienst versucht hat, zu registrieren, aber ein Fehler aufgetreten ist, hat Sammlungen sowohl für Registrierungen als auch für Fehler aufgefüllt. Ein Gerät, für das der Dienst keine Registrierungsanforderungen empfangen hat, verfügt sowohl für Registrierungen als auch für Fehler über leere Sammlungen.

Das folgende Beispiel zeigt ein Gerät, das erfolgreich für die Verwaltung von Featureupdates durch den Dienst 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 durch den Dienst oder Aufheben der Registrierung beim Dienst

Wenn Sie die Registrierung eines Geräts von der Verwaltung durch den Dienst für eine bestimmte Updatekategorie aufheben, wird das Gerät nicht mehr vom Bereitstellungsdienst verwaltet und erhält 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 beim Dienst registriert und wird weiterhin registriert und empfängt Inhalte für andere Updatekategorien (falls zutreffend).

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 beim Dienst vollständig aufheben, indem Sie das Geräteobjekt löschen. Wenn die Registrierung eines Geräts aufgehoben wird, wird es automatisch von der Verwaltung durch den Dienst 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