Gérer les règles de surveillance à l’aide du service de déploiement Windows Update entreprise

Pour les déploiements initiés par le service de déploiement, vous pouvez utiliser une règle de surveillance pour configurer des alertes et des actions automatisées en fonction des signaux de déploiement.

Les règles de surveillance sont compatibles avec les déploiements de mises à jour de fonctionnalités Windows 10.

Étape 1 : Créer une règle de surveillance

Vous pouvez créer une règle de surveillance pour un déploiement en configurant les paramètres de surveillance. Chaque déploiement peut avoir une règle de supervision active à la fois.

Les règles de surveillance se composent de trois composants :

• signal : type de problème de mise à jour à surveiller par le service de déploiement.
• seuil : lorsque ce pourcentage d’appareils émet le signal spécifié, la règle de surveillance est déclenchée.
• action : action à effectuer lorsque la règle de surveillance est déclenchée.

L’exemple suivant montre comment créer une règle d’analyse pour un déploiement en même temps que la création du déploiement.

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.catalogContent",
        "catalogEntry": {
            "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "monitoring": {
            "monitoringRules": [
                {
                    "signal": "rollback",
                    "threshold": 5,
                    "action": "pauseDeployment"
                }
            ]
        }
    }
}

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.catalogContent"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "monitoring": {
            "monitoringRules": [
                {
                    "@odata.type": "#microsoft.graph.windowsUpdates.monitoringRule",
                    "signal": "rollback",
                    "threshold": 5,
                    "action": "pauseDeployment"
                }
            ]
        },
        "schedule": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Étape 2 : Reprendre un déploiement suspendu par une règle de surveillance

Lorsqu’une règle de surveillance se déclenche, elle offre la possibilité d’examiner les problèmes de mise à jour qui peuvent avoir conduit à son application. Après examen, vous souhaiterez peut-être reprendre le déploiement. Il existe deux façons de procéder : supprimer la règle de surveillance ou mettre à jour le seuil de la règle de surveillance.

Exemple : Reprendre le déploiement en supprimant une règle d’analyse

Lorsqu’une règle de surveillance qui suspend le déploiement est déclenchée, l’une des façons de reprendre le déploiement consiste à supprimer la règle.

L’exemple suivant montre comment reprendre le déploiement en supprimant la règle.

Demande

PATCH https://graph.microsoft.com/beta/admin/windows/updates/deployments/b5171742-1742-b517-4217-17b5421717b5
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "monitoring": {
            "monitoringRules": []
        }
    }
}

Réponse

HTTP/1.1 202 Accepted
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",
        "monitoring": {
            "monitoringRules": []
        },
        "schedule": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Exemple : Reprendre le déploiement en mettant à jour un seuil de règle de surveillance

Une autre façon de reprendre le déploiement consiste à modifier le seuil de la règle de surveillance appropriée. Lorsque le nouveau seuil est atteint, l’action (dans ce cas, pauseDeployment) est à nouveau déclenchée.

L’exemple suivant montre comment reprendre le déploiement en modifiant le seuil de règle de surveillance. Cet exemple montre également comment modifier une règle de surveillance existante, même si son seuil n’a pas encore été atteint, ainsi que comment créer une règle de surveillance sur un déploiement qui n’en a pas.

Demande

PATCH https://graph.microsoft.com/beta/admin/windows/updates/deployments/b5171742-1742-b517-4217-17b5421717b5
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "monitoring": {
            "monitoringRules": [
                {
                    "signal": "rollback",
                    "threshold": 10,
                    "action": "pauseDeployment"
                }
            ]
        }
    }
}

Réponse

HTTP/1.1 202 Accepted
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",
        "monitoring": {
            "monitoringRules": [
                {
                    "@odata.type": "#microsoft.graph.windowsUpdates.monitoringRule",
                    "signal": "rollback",
                    "threshold": 10,
                    "action": "pauseDeployment"
                }
            ]
        },
        "schedule": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}