Windows Autopatch による更新管理に登録する

Windows Autopatch による更新管理にデバイスを登録する場合、Windows Autopatch を使用して、Windows Updateからそのデバイスに配信されるコンテンツを管理できます。 更新カテゴリ別の更新管理にデバイスを登録できます。

現在、Windows Autopatch では、Windows 10/11 機能更新プログラムとドライバー更新プログラムのデバイス登録がサポートされています。 現時点では、ホットパッチまたは迅速な品質更新プログラムを展開するために、Windows 10/11 品質更新プログラムの管理にデバイス登録は必要ありません。

更新管理にデバイスを登録する

特定の更新プログラム カテゴリの管理にデバイスを登録すると、Windows Autopatch は、Windows Updateからのそのカテゴリの更新プログラムの権限になります。 その結果、デバイスは、展開に割り当てて更新プログラムを展開するまで、Windows Updateからそのカテゴリの更新プログラムを受け取りません。 デバイスは、Windows Autopatch によって管理に登録されると自動的に登録されます (つまり、 azureADDevice オブジェクトがまだ存在しない場合は自動的に作成されます)。 ドライバーの登録については、「 ドライバー管理にデバイスを登録する」を参照してください。

次の例は、機能更新プログラム管理にデバイスを登録する方法を示しています。

要求

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)"
    }
  ]
}

応答

HTTP/1.1 202 Accepted

デバイスの登録状態を確認する

デバイスを取得し、azureADDevice オブジェクトの登録とエラーのプロパティを調べることで、デバイスの登録状態をチェックできます。 更新管理に正常に登録されたデバイスには、登録コレクションに updateManagementEnrollment オブジェクトがあり、errors コレクションに updateableAssetError オブジェクトがありません。 登録しようとしたがエラーが発生したデバイスには、登録とエラーの両方のコレクションが設定されています。 登録要求のないデバイスには、登録とエラーの両方に対して空のコレクションがあります。

次の例は、機能更新プログラムの管理に正常に登録されたデバイスを示しています。

要求

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

応答

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"
      }
    ]
  }
}

管理からの登録解除または登録解除

特定の更新カテゴリの管理からデバイスの登録を解除すると、デバイスは管理対象と見なされなくなり、ポリシー構成に基づいてWindows Updateから他の更新プログラムの受信を開始する可能性があります。 登録解除されたデバイスは、特定の更新カテゴリのコンテンツを含むすべての対象ユーザーと展開から削除されます。 デバイスは引き続き登録され、該当する場合は、他の更新プログラム カテゴリのコンテンツが登録され、受信されます。

要求

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)"
    }
  ]
}

応答

HTTP/1.1 202 Accepted

デバイス オブジェクトを削除することで、デバイスの登録を完全に解除できます。 デバイスの登録が解除されると、すべての更新カテゴリの管理から自動的に登録解除され、すべての展開から削除されます。

要求

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

応答

HTTP/1.1 202 Accepted