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