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
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 Microsoft Entra gefährdeten Benutzer dar. Microsoft Entra ID Protection wertet das Benutzerrisiko basierend auf verschiedenen Signalen und maschinellem Lernen kontinuierlich aus. Diese API bietet programmgesteuerten Zugriff für alle gefährdeten Benutzer in Ihrem Microsoft Entra Mandanten.
Weitere Informationen zu Risikoereignissen finden Sie unter Microsoft Entra ID Protection.
Hinweis
- Für die Verwendung der riskyUsers-API ist eine Microsoft Entra ID P2-Lizenz erforderlich.
- Die Verfügbarkeit riskanter Benutzerdaten wird durch die Microsoft Entra Datenaufbewahrungsrichtlinien geregelt.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | riskyUser-Sammlung | Rufen Sie eine Liste der riskyUser-Objekte und deren Eigenschaften ab. |
| Get | riskyUser | Liest die Eigenschaften und Beziehungen eines riskyUser-Objekts . |
| Gefährdung bestätigen | Keine | Bestätigen Sie, dass ein oder mehrere riskyUser-Objekte kompromittiert sind. |
| Als sicher bestätigen | Keine | Bestätigen Sie ein oder mehrere riskyUser-Objekte als sicher. |
| Dismiss | Keine | Schließen Sie das Risiko eines oder mehrerer riskyUser-Objekte . |
| Verlauf auflisten | riskyUserHistoryItem-Auflistung | Rufen Sie riskyUserHistoryItems aus der Verlaufsnavigationseigenschaft ab. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | string | Eindeutige ID des gefährdeten Benutzers. |
| isDeleted | Boolean | Gibt an, ob der Benutzer gelöscht wird. Die möglichen Werte sind: true, false. |
| isProcessing | Boolean | Gibt an, ob der risikobehaftete Zustand eines Benutzers vom Back-End verarbeitet wird. |
| riskLastUpdatedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der letzten Aktualisierung des risikobehafteten Benutzers. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. |
| riskLevel | riskLevel | Ebene des erkannten risikobehafteten Benutzers. Die möglichen Werte sind low, medium, high, hidden, none, . unknownFutureValue |
| riskState | riskState | Status des Risikos des Benutzers. Mögliche Werte sind: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue. |
| riskDetail | riskDetail | Details zum erkannten Risiko. Anmerkung: Details für diese Eigenschaft sind nur für Microsoft Entra ID P2-Kunden verfügbar. Alle anderen Kunden werden zurückgegeben hidden. |
| userDisplayName | string | Anzeigename riskanter Benutzer. |
| userPrincipalName | string | Riskanter Benutzerprinzipalname. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"id": "string",
"riskLastUpdatedDateTime": "dateTimeOffset",
"isProcessing": "Boolean",
"isDeleted": "Boolean",
"riskDetail": "string",
"riskLevel": "string",
"riskState": "string",
"userDisplayName": "string",
"userPrincipalName": "string"
}