Compartir a través de

tipo de recurso alertRule

Espacio de nombres: microsoft.graph.deviceManagement

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una regla que un administrador de TI con los roles adecuados puede configurar para supervisar problemas y desencadenar alertas en el Centro de administración de Microsoft Endpoint Manager.

Cuando se alcanza el umbral de una alertRule , se genera y almacena un alertRecord y los administradores reciben notificaciones a través de canales de notificación definidos.

Para obtener más información, consulte el recurso de supervisión .

Nota:

Esta API forma parte del conjunto de API de supervisión de alertas, que actualmente solo admite escenarios de Windows 365 y pc en la nube. El conjunto de API permite a los administradores configurar reglas para alertar de problemas con el aprovisionamiento de equipos en la nube, la carga de imágenes de PC en la nube y la comprobación de las conexiones de red de Azure.

¿Tiene otro escenario que pueda usar la compatibilidad adicional con alertas mediante programación en el Centro de administración de Microsoft Endpoint Manager? Sugiera la característica o vote por las solicitudes de características existentes.

Método Tipo devuelto Descripción
Enumerar alertRules Colección microsoft.graph.deviceManagement.alertRule Obtenga una lista de los objetos alertRule y sus propiedades.
Creación de alertRule microsoft.graph.deviceManagement.alertRule Cree un objeto alertRule .
Obtener alertRule microsoft.graph.deviceManagement.alertRule Lea las propiedades y relaciones de un objeto alertRule .
Actualizar alertRule microsoft.graph.deviceManagement.alertRule Actualice las propiedades de un objeto alertRule .

Propiedades

Propiedad Tipo Descripción
alertRuleTemplate microsoft.graph.deviceManagement.alertRuleTemplate Plantilla de regla del evento de alerta. Los valores posibles son: cloudPcProvisionScenario, cloudPcImageUploadScenario, cloudPcOnPremiseNetworkConnectionCheckScenario, unknownFutureValue, cloudPcInGracePeriodScenario, cloudPcFrontlineInsufficientLicensesScenario, cloudPcInaccessibleScenario, cloudPcFrontlineConcurrencyScenario, cloudPcUserSettingsPersistenceScenario y cloudPcDeprovisionFailedScenario. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: cloudPcInGracePeriodScenario, cloudPcFrontlineInsufficientLicensesScenario, cloudPcInaccessibleScenario, cloudPcFrontlineConcurrencyScenario, , cloudPcUserSettingsPersistenceScenariocloudPcDeprovisionFailedScenario.
description Cadena Descripción de la regla.
displayName String Nombre para mostrar de la regla.
habilitado Booleano Estado de la regla que indica si la regla está habilitada o deshabilitada. Si truees , la regla está habilitada; de lo contrario, la regla está deshabilitada.
id Cadena Identificador único de la regla de alertas. Heredado de la entidad.
isSystemRule Booleano Indica si la regla es una regla del sistema. Si truees , la regla es una regla del sistema; de lo contrario, la regla es una regla definida personalizada y se puede editar. Las reglas del sistema están integradas y solo se pueden editar algunas propiedades.
notificationChannels Colección microsoft.graph.deviceManagement.notificationChannel Canales de notificación de la regla seleccionada por el usuario.
severity microsoft.graph.deviceManagement.ruleSeverityType Gravedad de la regla. Los valores posibles son: unknown, informational, warning, critical, unknownFutureValue.
umbral microsoft.graph.deviceManagement.ruleThreshold Condiciones que determinan cuándo enviar alertas. Por ejemplo, puede configurar una condición para enviar una alerta cuando se produce un error en el aprovisionamiento de seis o más equipos en la nube. Esta propiedad está en desuso. Use condiciones en su lugar.
conditions Colección microsoft.graph.deviceManagement.ruleCondition Condiciones que determinan cuándo enviar alertas. Por ejemplo, puede configurar una condición para enviar una alerta cuando se produce un error en el aprovisionamiento de seis o más equipos en la nube.

valores alertRuleTemplate

Member Descripción
cloudPcProvisionScenario La regla de alertas se desencadenó para un problema con el aprovisionamiento del equipo en la nube. En el caso de una regla del sistema, la regla de alerta se desencadenó para un error de aprovisionamiento de equipos en la nube.
cloudPcImageUploadScenario La regla de alertas se desencadenó para un problema con el proceso de carga de la imagen del equipo en la nube. En el caso de una regla del sistema, la regla de alerta se desencadenó por un error al cargar la imagen del equipo en la nube.
cloudPcOnPremiseNetworkConnectionCheckScenario La regla de alerta se desencadenó para un problema con la comprobación de la conexión de red local. En el caso de una regla del sistema, la regla de alerta se desencadenó por un error con la conexión de red local.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.
cloudPcInGracePeriodScenario La regla de alerta se desencadenó cuando el equipo en la nube entró en el período de gracia.
cloudPcFrontlineInsufficientLicensesScenario La regla de alertas se desencadenó para los equipos de frontline cloud en los que estaban activas más conexiones simultáneas de pc en la nube de las que permite el límite de simultaneidad.
cloudPcInaccessibleScenario La regla de alerta se desencadenó cuando los equipos en la nube no se pudieron conectar debido a un error de estado del host, errores de conexión o una interrupción de zona. Como alternativa, porque estaban bajo aprovisionamiento o restaurando el estado del dispositivo.
cloudPcFrontlineConcurrencyScenario Indica que la regla de alertas se desencadenó para todas las condiciones del uso de simultaneidad de los equipos en la nube de frontline. Incluye condiciones de uso del búfer por ahora.
cloudPcUserSettingsPersistenceScenario Indica que la regla de alertas está asociada a un escenario de almacenamiento de sincronización de experiencia del usuario de Frontline Cloud PC en el que el uso alcanzó límites o umbrales definidos.
cloudPcDeprovisionFailedScenario Indica que la regla de alertas se desencadenó cuando un equipo en la nube entró en un proceso de desaprovisionamiento erróneo.

valores ruleSeverityType

Member Descripción
desconocido El nivel de gravedad es unknown. Se usa para la inicialización.
informativo El nivel de gravedad es informational.
warning El nivel de gravedad es warning.
crítico El nivel de gravedad es critical.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.deviceManagement.alertRule",
  "alertRuleTemplate": "String",  
  "description": "String",
  "displayName": "String",
  "enabled": "Boolean",
  "id": "String (identifier)",
  "isSystemRule": "Boolean",
  "notificationChannels": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.notificationChannel"
    }
  ], 
  "severity": "String",
  "threshold": {
    "@odata.type": "microsoft.graph.deviceManagement.ruleThreshold"
  },
  "conditions": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.ruleCondition"
    }
  ]
}
  • Last updated on