Administración de reglas de supervisión mediante el servicio de implementación de Windows Update para empresas

  • Artículo

Para las implementaciones iniciadas por el servicio de implementación, puede usar una regla de supervisión para configurar alertas y acciones automatizadas basadas en señales de implementación.

Las reglas de supervisión son compatibles con las implementaciones de Windows 10 actualizaciones de características.

Paso 1: Creación de una regla de supervisión

Puede crear una regla de supervisión para una implementación configurando los valores de supervisión. Cada implementación puede tener una regla de supervisión activa a la vez.

Las reglas de supervisión constan de tres componentes:

  • signal: el tipo de problema de actualización que va a supervisar el servicio de implementación.
  • umbral: cuando este porcentaje de dispositivos emite la señal especificada, se desencadena la regla de supervisión.
  • acción: acción que se va a realizar cuando se desencadene la regla de supervisión.

En el ejemplo siguiente se muestra cómo crear una regla de supervisión para una implementación al mismo tiempo que se crea la implementación.

Solicitud

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

Respuesta

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

Paso 2: Reanudar una implementación pausada por una regla de supervisión

Cuando se desencadena una regla de supervisión, proporciona la oportunidad de investigar los problemas de actualización que pueden haber llevado a su aplicación. Después de la investigación, es posible que desee reanudar la implementación. Hay dos maneras de hacerlo: quitar la regla de supervisión o actualizar el umbral de regla de supervisión.

Ejemplo: Reanudar la implementación mediante la eliminación de una regla de supervisión

Cuando se desencadena una regla de supervisión que pausa la implementación, una manera de reanudar la implementación es quitar la regla.

En el ejemplo siguiente se muestra cómo reanudar la implementación quitando la regla.

Solicitud

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

Respuesta

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

Ejemplo: Reanudar la implementación actualizando un umbral de regla de supervisión

Otra manera de reanudar la implementación es cambiar el umbral de la regla de supervisión pertinente. Cuando se alcanza el nuevo umbral, la acción (en este caso, pauseDeployment) se desencadenará de nuevo.

En el ejemplo siguiente se muestra cómo reanudar la implementación cambiando el umbral de regla de supervisión. En este ejemplo también se muestra cómo editar cualquier regla de supervisión existente, incluso si aún no se ha alcanzado su umbral, así como cómo crear una regla de supervisión en una implementación que no tiene una.

Solicitud

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

Respuesta

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