Verwalten von Überwachungsregeln mithilfe von Windows Autopatch

Für Bereitstellungen, die von Windows Autopatch initiiert werden, können Sie eine Überwachungsregel verwenden, um Warnungen und automatisierte Aktionen basierend auf Bereitstellungssignalen zu konfigurieren.

Überwachungsregeln sind mit Bereitstellungen von Windows 10 Featureupdates kompatibel.

Schritt 1: Erstellen einer Überwachungsregel

Sie können eine Überwachungsregel für eine Bereitstellung erstellen, indem Sie die Überwachungseinstellungen konfigurieren. Jede Bereitstellung kann jeweils über eine aktive Überwachungsregel verfügen.

Überwachungsregeln bestehen aus drei Komponenten:

• signal: Der Typ des zu überwachenden Updateproblems.
• schwellenwert: Wenn dieser Prozentsatz der Geräte das angegebene Signal ausgibt, wird die Überwachungsregel ausgelöst.
• action: Die Aktion, die ausgeführt werden soll, wenn die Überwachungsregel ausgelöst wird.

Im folgenden Beispiel wird gezeigt, wie Sie gleichzeitig mit der Erstellung der Bereitstellung eine Überwachungsregel für eine Bereitstellung erstellen.

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",
        "monitoring": {
            "monitoringRules": [
                {
                    "signal": "rollback",
                    "threshold": 5,
                    "action": "pauseDeployment"
                }
            ]
        }
    }
}

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

Schritt 2: Fortsetzen einer Bereitstellung, die von einer Überwachungsregel angehalten wurde

Wenn eine Überwachungsregel ausgelöst wird, bietet sie die Möglichkeit, Updateprobleme zu untersuchen, die möglicherweise zur Anwendung geführt haben. Nach der Untersuchung möchten Sie die Bereitstellung möglicherweise fortsetzen. Hierfür gibt es zwei Möglichkeiten: Entfernen der Überwachungsregel oder Aktualisieren des Schwellenwerts für Überwachungsregel.

Beispiel: Fortsetzen der Bereitstellung durch Entfernen einer Überwachungsregel

Wenn eine Überwachungsregel ausgelöst wird, die die Bereitstellung anhält, besteht eine Möglichkeit zum Fortsetzen der Bereitstellung darin, die Regel zu entfernen.

Das folgende Beispiel zeigt, wie Sie die Bereitstellung fortsetzen, indem Sie die Regel entfernen.

Anforderung

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": []
        }
    }
}

Antwort

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)"
}

Beispiel: Fortsetzen der Bereitstellung durch Aktualisieren eines Überwachungsregelschwellenwerts

Eine weitere Möglichkeit, die Bereitstellung fortzusetzen, besteht darin, den Schwellenwert der relevanten Überwachungsregel zu ändern. Wenn der neue Schwellenwert erreicht wird, wird die Aktion (in diesem Fall pauseDeployment) erneut ausgelöst.

Im folgenden Beispiel wird gezeigt, wie Sie die Bereitstellung fortsetzen, indem Sie den Schwellenwert für die Überwachungsregel ändern. In diesem Beispiel wird auch veranschaulicht, wie sie eine vorhandene Überwachungsregel bearbeiten, selbst wenn deren Schwellenwert noch nicht erreicht wurde, und wie eine Überwachungsregel für eine Bereitstellung erstellt wird, die über keine verfügt.

Anforderung

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"
                }
            ]
        }
    }
}

Antwort

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)"
}