ビジネス向け更新プログラムの展開サービスWindows更新プログラムの管理に登録する

Windows Update for Business 展開サービスによってデバイスを更新管理に登録すると、展開サービスを使用して、Windows Update からそのデバイスに配信されるコンテンツを管理できます。 更新プログラムのカテゴリ別にデバイスを更新管理に登録できます。

現在、展開サービスは、機能更新プログラムの管理における登録Windows 10サポートしています。 現時点では、迅速な品質更新プログラムを展開するためにWindows 10サービスは、品質更新プログラムの管理への登録を必要とします。

更新プログラムの管理にデバイスを登録する

特定の更新カテゴリの管理にデバイスを登録すると、展開サービスは、更新プログラムから提供されるそのカテゴリの更新Windowsになります。 その結果、展開サービスを使用して展開サービスを使用して更新プログラムを展開するまで、デバイスは Windows Update からそのカテゴリの更新プログラムを受信できません。 サービスによって管理に登録されると、デバイスはサービスに自動的に登録されます ( つまり、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

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

要求

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

応答

HTTP/1.1 202 Accepted