Planifier un déploiement à l’aide du service Windows Update for Business

Lors du déploiement d’une mise à jour à l’aide du service de déploiement, vous pouvez planifier le déploiement afin que les appareils reçoivent la mise à jour à une date ultérieure.

Les fonctionnalités de planification sont compatibles avec les déploiements Windows 10 mises à jour de fonctionnalités.

Planifier un déploiement à une date ultérieure

Vous pouvez planifier un déploiement à une date ultérieure en configurant ses paramètres de déploiement. Dans l’exemple ci-dessous, la mise à jour sera proposée à tous les appareils affectés au déploiement le 1er juillet 2021.

Demande

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.featureUpdateReference",
        "version": "20H2"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
        "rollout": {
            "startDateTime": "2021-07-01T17:00:00Z",
        }
    }
}

Réponse

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.featureUpdateReference",
        "version": "20H2"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
        "rollout": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "endDateTime": null,
            "durationBetweenOffers": "P1D",
            "devicesPerOffer": null
        },
        "monitoring": null,
        "userExperience": null,
        "safeguard": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Étape d’un déploiement sur une période de temps

Vous pouvez également planifier un déploiement afin que les appareils affectés se voit proposer la mise à jour dans un déploiement progressif qui est progressivement mis à jour. La mise à jour est proposée aux sous-ensembles d’appareils affectés au déploiement à intervalles réguliers, avec la durée totale du déploiement déterminée par une date de fin ou un taux d’offre. Vous pouvez considérer le déploiement progressif comme une série d’événements de calendrier périodiques.

Exemple : étape d’un déploiement à intervalles réguliers entre les dates de début et de fin

Une façon de mettre en place un déploiement au fil du temps consiste à définir endDateTime du déploiement. Tous les appareils affectés au déploiement se voit proposer la mise à jour dans la fenêtre entre startDateTime et endDateTime. Si startDateTime n’est pas spécifié, le déploiement commence dès que les appareils sont affectés.

Dans cet exemple, vous configurez un nouveau déploiement afin qu’un nouvel ensemble d’appareils soit mis à jour chaque semaine (duréeBetweenOffers définie sur sept jours), à compter du 1er juillet 2021. La mise à jour est proposée à tous les appareils avant le 1er août 2021.

Demande

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.featureUpdateReference",
        "version": "20H2"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
        "rollout": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "endDateTime": "2021-08-01T17:00:00Z",
            "durationBetweenOffers": "P7D"
        }
    }
}

Réponse

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.featureUpdateReference",
        "version": "20H2"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
        "rollout": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "endDateTime": "2021-08-01T17:00:00Z",
            "durationBetweenOffers": "P7D",
            "devicesPerOffer": null
        },
        "monitoring": null,
        "userExperience": null,
        "safeguard": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Exemple : étape d’un déploiement à intervalles réguliers avec un nombre spécifié d’appareils à chaque offre

Une autre façon de mettre en place un déploiement au fil du temps consiste à configurer le taux d’offre à l’aide devicesPerOffer de . La mise à jour sera proposée aux appareils affectés au déploiement en fonction du taux spécifié jusqu’à ce que la mise à jour soit proposée à tous les appareils.

Dans cet exemple, vous configurez un nouveau déploiement afin qu’un nouvel ensemble d’appareils soit mis à jour chaque semaine (duréeBetweenOffers définie sur sept jours), à compter du 1er juillet 2021. La mise à jour est proposée à 100 appareils à la fois jusqu’à ce que la mise à jour soit proposée à tous les appareils.

Demande

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.featureUpdateReference",
        "version": "20H2"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
        "rollout": {
            "startDateTime": "2020-07-01T17:00:00Z",
            "devicesPerOffer": 100,
            "durationBetweenOffers": "P7D"
        }
    }
}

Réponse

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.featureUpdateReference",
        "version": "20H2"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
        "rollout": {
            "startDateTime": "2020-07-01T17:00:00Z",
            "devicesPerOffer": 100,
            "durationBetweenOffers": "P7D",
            "endDateTime": null
        },
        "monitoring": null,
        "userExperience": null,
        "safeguard": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}