Share via


updatableAsset: enrollAssets

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.

Registrieren sie updatableAsset-Ressourcen bei der Updateverwaltung durch den Bereitstellungsdienst.

Sie können eine azureADDevice-Ressource für die Updateverwaltung registrieren, aber keine updatableAssetGroup für die Updateverwaltung registrieren.

Wenn Sie ein Microsoft Entra Gerät bei der Updateverwaltung registrieren, wird automatisch ein azureADDevice-Objekt erstellt, sofern es noch nicht vorhanden ist.

Sie können auch die Methode enrollAssetsById verwenden, um Ressourcen zu registrieren.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) WindowsUpdates.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung WindowsUpdates.ReadWrite.All Nicht verfügbar.

Damit eine App alle Windows Update-Bereitstellungseinstellungen mit delegierten Berechtigungen lesen oder schreiben kann, muss dem angemeldeten Benutzer die Rollen Globaler Administrator, Intune Administrator oder Windows Update BereitstellungsadministratorMicrosoft Entra zugewiesen werden.

HTTP-Anforderung

POST /admin/windows/updates/updatableAssets/enrollAssets

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie als Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Aktion verwendet werden können.

Parameter Typ Beschreibung
updateCategory microsoft.graph.windowsUpdates.updateCategory Die Kategorie der Zu verwaltenden Updates des Diensts. Unterstützt eine Teilmenge der Werte für updateCategory. Mögliche Werte: driver, feature, quality, unknownFutureValue
assets microsoft.graph.windowsUpdates.updatableAsset-Sammlung Liste der updatableAsset-Ressourcen , die durch den Dienst für die angegebene updateCategory bei der Updateverwaltung registriert werden sollen.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben. Es gibt nichts im Antworttext zurück.

Beispiele

Anforderung

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

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

Antwort

HTTP/1.1 202 Accepted