Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 den Datensatz eines Warnungsereignisses im Microsoft Endpoint Manager Admin Center dar, das von einer alertRule ausgelöst wird.
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.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | microsoft.graph.deviceManagement.alertRecord-Sammlung | Rufen Sie eine Liste der alertRecord-Objekte und deren Eigenschaften ab. |
| Get | microsoft.graph.deviceManagement.alertRecord | Liest die Eigenschaften und Beziehungen eines alertRecord-Objekts . |
| Portalbenachrichtigungen abrufen | microsoft.graph.deviceManagement.portalNotification-Sammlung | Rufen Sie eine Liste aller Portalbenachrichtigungen ab, auf die ein oder mehrere Benutzer zugreifen können, aus dem Microsoft Endpoint Manager Admin Center. |
| Portalbenachrichtigung als gesendet festlegen | Keine | Legen Sie die status der angegebenen Benachrichtigung im Microsoft EndPoint Manager Admin Center als gesendet fest. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| alertImpact | microsoft.graph.deviceManagement.alertImpact | Die Auswirkung des Warnungsereignisses. Besteht aus einer Liste von Schlüssel-Wert-Paaren und einer Zahl gefolgt vom Aggregationstyp. Bedeutet beispielsweise, 6 affectedCloudPcCount dass 6 Cloud-PCs betroffen sind.
12 affectedCloudPcPercentage bedeutet, dass 12 % der Cloud-PCs betroffen sind. Die Liste der Schlüssel-Wert-Paare gibt die Details der Warnungsauswirkungen an. |
| alertRuleId | Zeichenfolge | Die entsprechende ID der Warnungsregel. |
| alertRuleTemplate | microsoft.graph.deviceManagement.alertRuleTemplate | Die Regelvorlage des Warnungsereignisses. Mögliche Werte sind: cloudPcProvisionScenario, cloudPcImageUploadScenario, cloudPcOnPremiseNetworkConnectionCheckScenario, unknownFutureValue, cloudPcInGracePeriodScenario, cloudPcFrontlineInsufficientLicensesScenario, cloudPcInaccessibleScenario, cloudPcFrontlineConcurrencyScenario, cloudPcUserSettingsPersistenceScenario, cloudPcDeprovisionFailedScenario. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: cloudPcInGracePeriodScenario, cloudPcFrontlineInsufficientLicensesScenario, cloudPcInaccessibleScenario, cloudPcFrontlineConcurrencyScenario, cloudPcUserSettingsPersistenceScenario, cloudPcDeprovisionFailedScenario. |
| detectedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der Erkennung des Warnungsereignisses. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. |
| displayName | Zeichenfolge | Der Anzeigename des Warnungsdatensatzes. |
| id | Zeichenfolge | Der eindeutige Bezeichner für den Warnungsdatensatz. Geerbt von entity. |
| lastUpdatedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der letzten Aktualisierung des Warnungsdatensatzes. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. |
| resolvedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der Auflösung des Warnungsereignisses. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. |
| Schweregrad | microsoft.graph.deviceManagement.ruleSeverityType | Der Schweregrad des Warnungsereignisses. Mögliche Werte sind: unknown, informational, warning, critical, unknownFutureValue. |
| status | microsoft.graph.deviceManagement.alertStatusType | Die status des Warnungsdatensatzes. Die möglichen Werte sind: active, resolved, unknownFutureValue. |
alertStatusType-Werte
| Member | Beschreibung |
|---|---|
| aktiv | Die Warnung ist aktiv. |
| resolved | Die Warnung ist als gelöst gekennzeichnet. |
| 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.alertRecord",
"alertImpact": {
"@odata.type": "microsoft.graph.deviceManagement.alertImpact"
},
"alertRuleId": "String",
"alertRuleTemplate": "String",
"detectedDateTime": "String (timestamp)",
"displayName": "String",
"id": "String (identifier)",
"lastUpdatedDateTime": "String (timestamp)",
"resolvedDateTime": "String (timestamp)",
"severity": "String",
"status": "String"
}