alertRule-Ressourcentyp

Artikel
12/25/2024

Namespace: microsoft.graph.deviceManagement

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Regel dar, die ein IT-Administrator mit den entsprechenden Rollen konfigurieren kann, um Probleme zu überwachen und Warnungen im Microsoft Endpoint Manager Admin Center auszulösen.

Wenn der Schwellenwert einer alertRule erreicht wird, wird ein alertRecord generiert und gespeichert, und Administratoren erhalten Benachrichtigungen über definierte Benachrichtigungskanäle.

Weitere Informationen finden Sie in der Überwachungsressource .

Hinweis

Diese API ist Teil des API-Satzes für die Warnungsüberwachung, der derzeit nur Windows 365- und Cloud-PC-Szenarien unterstützt. Mit dem API-Satz können Administratoren Regeln einrichten, um Probleme bei der Bereitstellung von Cloud-PCs, dem Hochladen von Cloud-PC-Images und dem Überprüfen von Azure-Netzwerkverbindungen zu warnen.

Haben Sie ein anderes Szenario, das zusätzliche programmgesteuerte Warnungsunterstützung im Microsoft Endpoint Manager Admin Center verwenden kann? Schlagen Sie das Feature vor oder stimmen Sie für vorhandene Featureanforderungen ab.

Methode	Rückgabetyp	Beschreibung
AlertRules auflisten	microsoft.graph.deviceManagement.alertRule-Sammlung	Rufen Sie eine Liste der alertRule-Objekte und deren Eigenschaften ab.
Erstellen von alertRule	microsoft.graph.deviceManagement.alertRule	Erstellen Sie ein alertRule-Objekt .
AlertRule abrufen	microsoft.graph.deviceManagement.alertRule	Lesen der Eigenschaften und Beziehungen eines alertRule-Objekts .
Aktualisieren von alertRule	microsoft.graph.deviceManagement.alertRule	Aktualisieren sie die Eigenschaften eines alertRule-Objekts .

Eigenschaften

Eigenschaft	Typ	Beschreibung
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	Die Regelvorlage des Warnungsereignisses. Die möglichen Werte sind: `cloudPcProvisionScenario`, `cloudPcImageUploadScenario`, `cloudPcOnPremiseNetworkConnectionCheckScenario`, `unknownFutureValue`, `cloudPcInGracePeriodScenario`, `cloudPcFrontlineInsufficientLicensesScenario`, `cloudPcInaccessibleScenario`und `cloudPcFrontlineConcurrencyScenario`. Beachten Sie, dass Sie den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden müssen, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: `cloudPcInGracePeriodScenario`, `cloudPcFrontlineInsufficientLicensesScenario`, `cloudPcInaccessibleScenario`und `cloudPcFrontlineConcurrencyScenario`.
description	Zeichenfolge	Die Regelbeschreibung.
displayName	Zeichenfolge	Der Anzeigename der Regel.
aktiviert	Boolescher Wert	Die status der Regel, die angibt, ob die Regel aktiviert oder deaktiviert ist. Wenn `true`, ist die Regel aktiviert, andernfalls ist die Regel deaktiviert.
id	Zeichenfolge	Der eindeutige Bezeichner für die Warnungsregel. Geerbt von entity.
isSystemRule	Boolescher Wert	Gibt an, ob es sich bei der Regel um eine Systemregel handelt. Wenn `true`, ist die Regel eine Systemregel. Andernfalls handelt es sich bei der Regel um eine benutzerdefinierte Regel, die bearbeitet werden kann. Systemregeln sind integriert, und nur wenige Eigenschaften können bearbeitet werden.
notificationChannels	microsoft.graph.deviceManagement.notificationChannel-Sammlung	Die Benachrichtigungskanäle der vom Benutzer ausgewählten Regel.
Schweregrad	microsoft.graph.deviceManagement.ruleSeverityType	Der Schweregrad der Regel. Mögliche Werte sind: `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
Schwelle	microsoft.graph.deviceManagement.ruleThreshold	Die Bedingungen, die bestimmen, wann Warnungen gesendet werden sollen. Sie können beispielsweise eine Bedingung so konfigurieren, dass eine Warnung gesendet wird, wenn bei der Bereitstellung für sechs oder mehr Cloud-PCs ein Fehler auftritt. Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Bedingungen.
Bedingungen	microsoft.graph.deviceManagement.ruleCondition-Sammlung	Die Bedingungen, die bestimmen, wann Warnungen gesendet werden sollen. Sie können beispielsweise eine Bedingung so konfigurieren, dass eine Warnung gesendet wird, wenn bei der Bereitstellung für sechs oder mehr Cloud-PCs ein Fehler auftritt.

alertRuleTemplate-Werte

Member	Beschreibung
cloudPcProvisionScenario	Die Warnungsregel wurde für ein Problem mit der Cloud-PC-Bereitstellung ausgelöst. Bei einer Systemregel wurde die Warnungsregel für einen Cloud-PC-Bereitstellungsfehler ausgelöst.
cloudPcImageUploadScenario	Die Warnungsregel wurde für ein Problem mit dem Prozess zum Hochladen des Cloud-PC-Images ausgelöst. Bei einer Systemregel wurde die Warnungsregel ausgelöst, wenn das Cloud-PC-Image nicht hochgeladen wurde.
cloudPcOnPremiseNetworkConnectionCheckScenario	Die Warnungsregel wurde für ein Problem mit der Überprüfung der lokalen Netzwerkverbindung ausgelöst. Bei einer Systemregel wurde die Warnungsregel bei einem Fehler mit der lokalen Netzwerkverbindung ausgelöst.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
cloudPcInGracePeriodScenario	Die Warnungsregel wurde ausgelöst, als der Cloud-PC in die Toleranzperiode eingetreten ist.
cloudPcFrontlineInsufficientLicensesScenario	Die Warnungsregel wurde für die Frontline-Cloud-PCs ausgelöst, bei denen mehr gleichzeitige Cloud-PC-Verbindungen aktiv waren, als der Parallelitätsgrenzwert zulässt.
cloudPcInaccessibleScenario	Die Warnungsregel wurde ausgelöst, wenn Cloud-PCs aufgrund von Hostintegritätsfehlern, Verbindungsfehlern oder einem Zonenausfall keine Verbindung herstellen konnten. Alternativ dazu, weil das Gerät status bereitgestellt oder wiederhergestellt wurde.
cloudPcFrontlineConcurrencyScenario	Gibt an, dass die Warnungsregel für alle Bedingungen der Parallelitätsnutzung von Cloud-PCs in Frontline ausgelöst wurde. Es enthält vorerst Puffernutzungsbedingungen.

ruleSeverityType-Werte

Member	Beschreibung
unknown	Der Schweregrad ist `unknown`. Wird für die Initialisierung verwendet.
mitteilsam	Der Schweregrad ist `informational`.
warning	Der Schweregrad ist `warning`.
Kritisch	Der Schweregrad ist `critical`.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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

Freigeben über