Freigeben über

Bereitstellen eines beschleunigten Qualitätsupdates mithilfe von Windows Autopatch

  • Artikel

Mit Windows Autopatch können Sie Windows-Updates auf Geräten in einem Microsoft Entra Mandanten bereitstellen. Windows Autopatch unterstützt heute die Bereitstellung von Windows 10/11-Featureupdates, Hotpatch-Qualitätsupdates, beschleunigten Qualitätsupdates und Treiberupdates. Dieses Thema konzentriert sich auf die Bereitstellung beschleunigter Qualitätsupdates. Informationen zum Bereitstellen von Featureupdates finden Sie unter Bereitstellen eines Featureupdates. Informationen zum Bereitstellen von Hotpatch-Qualitätsupdates finden Sie unter Bereitstellen eines Hotpatch-Qualitätsupdates. Informationen zum Bereitstellen von Treiberupdates finden Sie unter Verwalten von Treiberupdates.

Das Beschleunigen eines Qualitätsupdates überschreibt Windows Update for Business-Zurückstellungsrichtlinien, damit das Update so schnell wie möglich installiert wird. Dies kann nützlich sein, wenn kritische Qualitätsereignisse auftreten und Sie die neuesten Updates schneller als normal bereitstellen müssen. Es kann zwar helfen, Complianceziele für ein bestimmtes Qualitätsupdate zu erreichen, ist jedoch nicht für die monatliche Verwendung konzipiert. Erwägen Sie stattdessen die Verwendung von Konformitätsstichtagen für Updates.

Wenn Sie ein beschleunigtes Qualitätsupdate auf einem Gerät bereitstellen, bietet Windows Update das neueste anwendbare Update für das Gerät an, wenn es das Update noch nicht mit dem angegebenen Veröffentlichungsdatum erhalten hat. Wenn Sie beispielsweise das am 13. April 2021 veröffentlichte Sicherheitsupdate Windows 10 auf einem Gerät bereitstellen, auf dem das Update derzeit nicht vorhanden ist, erhält das Gerät ein beschleunigtes Update. Wenn das Gerät bereits über das angegebene Update oder neuer verfügt, erhält es kein beschleunigtes Update.

Beschleunigte Qualitätsupdates weisen auch die folgenden Merkmale auf:

  • Das Update beginnt sofort, anstatt auf den nächsten regulären Updatescan zu warten, der standardmäßig alle 22 Stunden durchgeführt wird.
  • Das Update wird so schnell wie möglich heruntergeladen und installiert.
  • Der Aktualisierungsprozess setzt konfigurierte Geräterichtlinieneinstellungen außer Kraft, z. B. Tage, bis das Gerät zum Neustart gezwungen wird. Nachdem das beschleunigte Update installiert wurde, kehrt das Gerät zu den aktuellen Richtlinieneinstellungen zurück.

Voraussetzungen

Schritt 1: (Optional) Abrufen einer Liste mit beschleunigten Updates

Sie können die Windows Autopatch-Katalog-API abfragen, um eine Liste von Updates abzurufen, die als Inhalt in einer Bereitstellung auf Geräte beschleunigt werden können.

Qualitätsupdates werden durch den QualityUpdateCatalogEntry-Typ mit einer qualityUpdateClassification von security oder nonSecuritydargestellt. Alle Windows 10 Qualitätsupdates, die als security klassifiziert sind, und alle Windows 11 Qualitätsupdates, die als security klassifiziert sind oder non-security beschleunigt werden können.

Alle Qualitätsupdates beziehen sich auf eine Liste der Produktrevisionen. Fügen Sie $expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions der Anforderungs-URL hinzu, um zu ermitteln, auf welche Betriebssystembuilds sich die einzelnen Qualitätsupdates auswirken.

Das folgende Beispiel zeigt, wie Alle Windows 10 Qualitätsupdates abgefragt werden, die als beschleunigte Updates von Windows Autopatch bereitgestellt werden können. Es wird empfohlen, nur die drei aktuellen Updates anzuzeigen, sodass das folgende Beispiel enthält $top=3.

Anforderung

GET https://graph.microsoft.com/beta/admin/windows/updates/catalog/entries?$top=3&$filter=isof('microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry') and microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/isExpeditable eq true&$expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions&$orderby=releaseDateTime desc

Antwort

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries(microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions())",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET admin/windows/updates/catalog/entries?$select=deployableUntilDateTime,displayName",
    "value": [
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e",
            "displayName": "12/12/2023 - 2023.12 B SecurityUpdate for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-12-12T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "security",
            "catalogName": "2023-12 Cumulative Update for Windows 10 and later",
            "shortName": "2023.12 B",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": {
                "maxSeverity": "moderate",
                "maxBaseScore": 9.6,
                "exploitedCves@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/cveSeverityInformation/exploitedCves",
                "exploitedCves": []
            },
            "productRevisions@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions",
            "productRevisions": [
                {
                    "id": "10.0.19045.3803",
                    "displayName": "Windows 10, version 22H2, build 19045.3803",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19045,
                        "updateBuildRevision": 3803
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19045.3803')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033372",
                        "url": "https://support.microsoft.com/help/5033372"
                    }
                },
                {
                    "id": "10.0.22621.2861",
                    "displayName": "Windows 11, version 22H2, build 22621.2861",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22621,
                        "updateBuildRevision": 2861
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22621.2861')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033375",
                        "url": "https://support.microsoft.com/help/5033375"
                    }
                },
                {
                    "id": "10.0.22000.2652",
                    "displayName": "Windows 11, version 21H2, build 22000.2652",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22000,
                        "updateBuildRevision": 2652
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22000.2652')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033369",
                        "url": "https://support.microsoft.com/help/5033369"
                    }
                },
                {
                    "id": "10.0.19044.3803",
                    "displayName": "Windows 10, version 21H2, build 19044.3803",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19044,
                        "updateBuildRevision": 3803
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19044.3803')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033372",
                        "url": "https://support.microsoft.com/help/5033372"
                    }
                },
                {
                    "id": "10.0.22631.2861",
                    "displayName": "Windows 11, version 23H2, build 22631.2861",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "23H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22631,
                        "updateBuildRevision": 2861
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22631.2861')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033375",
                        "url": "https://support.microsoft.com/help/5033375"
                    }
                }
            ]
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd",
            "displayName": "11/30/2023 - 2023.11 D Update for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-11-30T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "nonSecurity",
            "catalogName": "2023-11 Cumulative Update Preview for Windows 10 and later",
            "shortName": "2023.11 D",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": null,
            "productRevisions@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions",
            "productRevisions": [
                {
                    "id": "10.0.19045.3758",
                    "displayName": "Windows 10, version 22H2, build 19045.3758",
                    "releaseDateTime": "2023-11-30T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19045,
                        "updateBuildRevision": 3758
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19045.3758')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032278",
                        "url": "https://support.microsoft.com/help/5032278"
                    }
                },
                {
                    "id": "10.0.22621.2792",
                    "displayName": "Windows 11, version 22H2, build 22621.2792",
                    "releaseDateTime": "2023-12-04T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22621,
                        "updateBuildRevision": 2792
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22621.2792')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032288",
                        "url": "https://support.microsoft.com/help/5032288"
                    }
                },
                {
                    "id": "10.0.22631.2792",
                    "displayName": "Windows 11, version 23H2, build 22631.2792",
                    "releaseDateTime": "2023-12-04T00:00:00Z",
                    "version": "23H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22631,
                        "updateBuildRevision": 2792
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22631.2792')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032288",
                        "url": "https://support.microsoft.com/help/5032288"
                    }
                }
            ]
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71",
            "displayName": "11/14/2023 - 2023.11 B SecurityUpdate for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-11-14T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "security",
            "catalogName": "2023-11 Cumulative Update for Windows 10 and later",
            "shortName": "2023.11 B",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": {
                "maxSeverity": "critical",
                "maxBaseScore": 9.8,
                "exploitedCves@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/cveSeverityInformation/exploitedCves",
                "exploitedCves": [
                    {
                        "number": "CVE-2023-36036",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-36036"
                    },
                    {
                        "number": "CVE-2023-36033",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-36033"
                    },
                    {
                        "number": "CVE-2023-36025",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-36025"
                    }
                ]
            },
            "productRevisions@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions",
            "productRevisions": [
                {
                    "id": "10.0.19045.3693",
                    "displayName": "Windows 10, version 22H2, build 19045.3693",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19045,
                        "updateBuildRevision": 3693
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19045.3693')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032189",
                        "url": "https://support.microsoft.com/help/5032189"
                    }
                },
                {
                    "id": "10.0.22621.2715",
                    "displayName": "Windows 11, version 22H2, build 22621.2715",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22621,
                        "updateBuildRevision": 2715
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22621.2715')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032190",
                        "url": "https://support.microsoft.com/help/5032190"
                    }
                },
                {
                    "id": "10.0.22000.2600",
                    "displayName": "Windows 11, version 21H2, build 22000.2600",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22000,
                        "updateBuildRevision": 2600
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22000.2600')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032192",
                        "url": "https://support.microsoft.com/help/5032192"
                    }
                },
                {
                    "id": "10.0.19044.3693",
                    "displayName": "Windows 10, version 21H2, build 19044.3693",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19044,
                        "updateBuildRevision": 3693
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19044.3693')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032189",
                        "url": "https://support.microsoft.com/help/5032189"
                    }
                },
                {
                    "id": "10.0.22631.2715",
                    "displayName": "Windows 11, version 23H2, build 22631.2715",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "23H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22631,
                        "updateBuildRevision": 2715
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22631.2715')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032190",
                        "url": "https://support.microsoft.com/help/5032190"
                    }
                }
            ]
        }
    ]
}

Schritt 2: Erstellen einer Bereitstellung

Eine Bereitstellung gibt den bereitzustellenden Inhalt an, wie und wann der Inhalt bereitgestellt werden soll, und die Zielgeräte. Bei Qualitätsupdates wird der Inhalt mithilfe eines Zielkonformitätsdatums angegeben. Wenn eine Bereitstellung erstellt wird, wird automatisch eine Bereitstellungszielgruppe als Beziehung erstellt.

Wenn Sie ein beschleunigtes Qualitätsupdate auf einem Gerät bereitstellen, bietet Windows Update ein Update an, das das Gerät über die angegebene Mindestkonformitätsstufe bringt. Je nachdem, wann jedes Gerät scannt und aktualisiert, erhalten einige Geräte möglicherweise neuere Updates (z. B. ein neueres Sicherheitsupdate als das, das der Mindestkonformitätsstufe entspricht), aber alle Geräte erfüllen den angegebenen Compliancestandard für Sicherheitsupdates. Dieses Verhalten des Anbietens des neuesten anwendbaren Updates, das durch die Eigenschaft equivalentContent angegeben wird, die auf den Standardwert latestSecurityfestgelegt ist, trägt dazu bei, geräte so sicher wie möglich zu halten und verhindert, dass ein Gerät ein beschleunigtes Update empfängt, gefolgt von einem weiteren regulären Update nur wenige Tage später.

Anmerkung: Wenn Sie ein beschleunigtes, nicht sicherheitsrelevantes Qualitätsupdate bereitstellen, muss es sich um das neueste veröffentlichte Qualitätsupdate handelt. Wenn Sie beispielsweise das 11D-Release beschleunigen, nachdem 12B veröffentlicht wurde, wird kein Update für die Geräte in der Bereitstellung beschleunigt.

Sie können die Toleranzperiode für den Geräteneustart mithilfe der Eigenschaft daysUntilForcedReboot in den Einstellungen für die Benutzererfahrung der Bereitstellung konfigurieren. Die Toleranzperiode legt die Zeitdauer nach der Installation fest, die der Benutzer beim Neustart des Geräts steuern kann. Wenn das Gerät bis zum Ablauf der Toleranzperiode nicht neu gestartet wurde, wird es automatisch neu gestartet.

Im Folgenden finden Sie ein Beispiel für das Erstellen einer Bereitstellung für ein beschleunigtes Qualitätsupdate. Die Zielgeräte werden im nächsten Schritt angegeben.

Anforderung

POST https://graph.microsoft.com/beta/admin/windows/updates/deployments
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        "catalogEntry": {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "expedite": {
            "isExpedited": true, 
            "isReadinessTest": false
        },
        "userExperience": {
            "daysUntilForcedReboot": 2
        }
    }
}

Antwort

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "id": "b5171742-1742-b517-4217-17b5421717b5",
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)",    
    "state": {
        "effectiveValue": "offering",
        "requestedValue": "none",
        "reasons": []
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent"
    },
    "settings": {
        "schedule": null,
        "monitoring": null,
        "contentApplicability": null,
        "userExperience": {
            "daysUntilForcedReboot": 2
        },
        "expedite": {
            "isExpedited": true
        }
    }
}

Schritt 3: Zuweisen von Geräten zur Bereitstellungszielgruppe

Nachdem die Bereitstellung erstellt wurde, können Sie der Bereitstellungszielgruppe Geräte zuweisen. Wenn die Bereitstellungszielgruppe erfolgreich aktualisiert wurde, bietet Windows Update das Update für die relevanten Geräte gemäß den Bereitstellungseinstellungen an.

Geräte werden automatisch registriert, wenn sie den Member- oder Ausschlusssammlungen einer Bereitstellungszielgruppe hinzugefügt werden (d. a. ein azureADDevice-Objekt wird automatisch erstellt, wenn es noch nicht vorhanden ist).

Das folgende Beispiel zeigt, wie Sie Microsoft Entra Geräte als Mitglieder der Bereitstellungszielgruppe hinzufügen.

Anforderung

POST https://graph.microsoft.com/beta/admin/windows/updates/deployments/{deploymentId}/audience/updateAudience
Content-type: application/json

{
    "addMembers": [
        {
            "@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

Während einer Bereitstellung

Während der Bereitstellung können Sie die Bereitstellung anhalten, indem Sie den Status aktualisieren und die Benutzergruppenmitglieder und Ausschlüsse aktualisieren.

Nach einer Bereitstellung

Nachdem allen Geräten, die einer Bereitstellungszielgruppe zugewiesen sind, das Update anfänglich angeboten wurde, wurde das Update aufgrund von Faktoren wie der Gerätekonnektivität möglicherweise nicht für alle Geräte gestartet oder abgeschlossen. Solange die Bereitstellung noch vorhanden ist, wird sichergestellt, dass Windows Update das Update für die zugewiesenen Geräte anbietet, wenn sie die Verbindung wiederherstellen.