alertRule-Ressourcentyp
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. Mögliche Werte sind: cloudPcProvisionScenario, cloudPcImageUploadScenario, cloudPcOnPremiseNetworkConnectionCheckScenario, cloudPcInGracePeriodScenario, cloudPcFrontlineInsufficientLicensesScenario, cloudPcInaccessibleScenario. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: cloudPcInGracePeriodScenario. |
| description | Zeichenfolge | Die Regelbeschreibung. |
| displayName | Zeichenfolge | Der Anzeigename der Regel. |
| aktiviert | Boolesch | 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 | Boolesch | 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. |
| cloudPcFrontlineBufferUsageScenario | Die Warnungsregel wurde für die Puffernutzung von Cloud-PCs in Frontline ausgelöst, wenn der Puffer über das Zeitlimit oder das Anzahllimit verwendet wird. Wenn die Mandanten alle Frontline-Lizenzen verwenden, gibt es eine vordefinierte Pufferzeit oder Anzahl von Lizenzen, die Cloud-PC-Benutzer weiterhin verwenden können. Diese Warnung wird ausgelöst, wenn Mandanten die gesamte gepufferte Zeit oder lizenzen verwenden. |
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"
}
]
}