Freigeben über

Planen einer Bereitstellung mithilfe von Windows Autopatch

  • Artikel

Wenn Sie ein Update mithilfe von Windows Autopatch bereitstellen, können Sie die Bereitstellung so planen, dass Geräte das Update zu einem späteren Zeitpunkt erhalten.

Planungsfeatures sind mit Bereitstellungen von Windows 10/Windows 11 Featureupdates kompatibel.

Planen einer Bereitstellung für den Start zu einem späteren Zeitpunkt

Sie können eine Bereitstellung so planen, dass sie zu einem späteren Zeitpunkt beginnt, indem Sie ihre Zeitplaneinstellungen konfigurieren. Im folgenden Beispiel wird allen Geräten, denen die Bereitstellung zugewiesen ist, das Update am 1. Juli 2021 angeboten.

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.featureUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
        }
    }
}

Antwort

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

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "id": "b5171742-1742-b517-4217-17b5421717b5",
    "state": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentState",
        "value": "offering",
        "reasons": [
            {
                "@odata.type": "microsoft.graph.windowsUpdates.deploymentStateReason",
                "value": "offeringByRequest"
            }
        ],
        "requestedValue": "none",
        "effectiveSinceDate": "String (timestamp)"
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "gradualRollout": null
        },
        "monitoring": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Bereitstellen einer Bereitstellung über einen bestimmten Zeitraum hinweg

Sie können eine Bereitstellung auch so planen, dass zugewiesenen Geräten das Update in einem schrittweisen Rollout angeboten wird, der im Laufe der Zeit bereitgestellt wird. Das Update wird teilmengen von Geräten angeboten, die der Bereitstellung in regelmäßigen Abständen zugewiesen sind, wobei die Gesamtdauer des Rollouts entweder durch ein Enddatum oder eine Angebotsrate bestimmt wird. Sie können sich eine schrittweise Einführung wie ein wiederkehrendes Kalenderereignis vorstellen.

Beispiel: Bereitstellen einer Bereitstellung in regelmäßigen Abständen zwischen Start- und Enddatum

Eine Möglichkeit, eine Bereitstellung im Laufe der Zeit zu stufen, besteht darin, endDateTime der Bereitstellung festzulegen. Allen Geräten, die der Bereitstellung zugewiesen sind, wird das Update innerhalb des Fensters zwischen startDateTime und endDateTime angeboten. Wenn startDateTime nicht angegeben ist, beginnt die Bereitstellung, sobald Geräte zugewiesen wurden.

In diesem Beispiel konfigurieren Sie eine neue Bereitstellung, sodass ab dem 1. Juli 2021 jede Woche eine neue Gruppe von Geräten das Update angeboten wird (dauerBetweenOffers ist auf sieben Tage festgelegt). Für alle Geräte wird das Update vor dem 1. August 2021 angeboten.

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.featureUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.dateDrivenRolloutSettings",
                "endDateTime": "2021-08-01T17:00:00Z",
                "durationBetweenOffers": "P7D"
            }
        }
    }
}

Antwort

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

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "id": "b5171742-1742-b517-4217-17b5421717b5",
    "state": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentState",
        "value": "offering",
        "reasons": [
            {
                "@odata.type": "microsoft.graph.windowsUpdates.deploymentStateReason",
                "value": "offeringByRequest"
            }
        ],
        "requestedValue": "none",
        "effectiveSinceDate": "String (timestamp)"
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.dateDrivenRolloutSettings",
                "endDateTime": "2021-08-01T17:00:00Z",
                "durationBetweenOffers": "P7D"
            }
        }
        "monitoring": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Beispiel: Bereitstellen einer Bereitstellung in regelmäßigen Abständen mit einer angegebenen Anzahl von Geräten für jedes Angebot

Eine weitere Möglichkeit, eine Bereitstellung im Laufe der Zeit zu stufen, besteht darin, die Angebotsrate mithilfe von devicesPerOfferzu konfigurieren. Geräten, die der Bereitstellung zugewiesen sind, wird das Update gemäß dem angegebenen Tarif angeboten, bis allen Geräten das Update angeboten wurde.

In diesem Beispiel konfigurieren Sie eine neue Bereitstellung, sodass ab dem 1. Juli 2021 jede Woche eine neue Gruppe von Geräten das Update angeboten wird (dauerBetweenOffers ist auf sieben Tage festgelegt). 100 Geräten wird das Update gleichzeitig angeboten, bis allen Geräten das Update angeboten wurde.

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.featureUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "startDateTime": "2020-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
                "durationBetweenOffers": "P7D",
                "devicePerOffer": 100
            }
        }
    }
}

Antwort

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

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "id": "b5171742-1742-b517-4217-17b5421717b5",
    "state": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentState",
        "value": "offering",
        "reasons": [
            {
                "@odata.type": "microsoft.graph.windowsUpdates.deploymentStateReason",
                "value": "offeringByRequest"
            }
        ],
        "requestedValue": "none",
        "effectiveSinceDate": "String (timestamp)"
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "startDateTime": "2020-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
                "durationBetweenOffers": "P7D",
                "devicePerOffer": 100
            }
        },
        "monitoring": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}