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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für