summarizedSignIn Ressourcentyp

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 ein zusammengefasstes Anmeldeereignis dar.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
Zusammengefasste MSI-Anmeldungen abrufen summarizedSignIn-Sammlung Rufen Sie eine Liste der Anzahl von MSI-Anmeldeereignissen ab, gruppiert nach Benutzer, Anwendung, IP-Adresse und Zeitfenster, mit Drilldown-Funktion unter Verwendung einzelner Anforderungs-IDs über den /signIns-Endpunkt .
Zusammenfassung der nicht interaktiven Anmeldungen summarizedSignIn-Sammlung Rufen Sie eine Liste der Anzahl von nicht interaktiven Anmeldeereignissen ab, gruppiert nach Benutzer, Anwendung, IP-Adresse und Zeitfenster, mit der Möglichkeit, einen Drilldown auszuführen, indem Sie einzelne Anforderungs-IDs über den /signIns-Endpunkt verwenden.
Zusammengefasste Dienstprinzipalanmeldungen abrufen summarizedSignIn-Sammlung Rufen Sie eine Liste der Anzahl von Dienstprinzipal-Anmeldeereignissen ab, gruppiert nach Benutzer, Anwendung, IP-Adresse und Zeitfenster, mit der Möglichkeit, einen Drilldown mithilfe einzelner Anforderungs-IDs über den /signIns-Endpunkt auszuführen.

Eigenschaften

Eigenschaft Typ Beschreibung
Agent microsoft.graph.agentic.agentSignIn Stellt Details zur Agenten-Anmeldung dar. Enthält den Typ des Agents sowie in einigen Fällen die übergeordnete appId. Unterstützt $filter (eq) für agentType.
aggregationDateTime DateTimeOffset Der aggregierte Tag, für den die Zusammenfassung gilt. Diese Eigenschaft repräsentiert immer den ganzen Tag. 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.
appDisplayName Zeichenfolge Der im Microsoft Entra Admin Center angezeigte Anwendungsname. Unterstützt $filter (eq).
appId Zeichenfolge Der Anwendungsbezeichner (Client-ID) in Microsoft Entra ID. Unterstützt $filter (eq).
conditionalAccessStatus conditionalAccessStatus Der Status der ausgelösten Richtlinie für bedingten Zugriff. Mögliche Werte sind: success, failure, notApplied, unknownFutureValue. Unterstützt $filter (eq).
firstSignInDateTime DateTimeOffset Das früheste Anmeldeereignis, das in dieser Zusammenfassung enthalten ist. Diese Eigenschaft repräsentiert immer den ganzen Tag. 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.
id Zeichenfolge Der Bezeichner, der die Anmeldeaktivität darstellt. Geerbt von entity. Unterstützt $filter (eq).
ipAddress String Die IP-Adresse, über die ein Benutzer oder autonomer Agent einen Ressourcenanbieter erreicht; diese wird verwendet, um die Einhaltung des bedingten Zugriffs für einige Richtlinien zu bestimmen. Wenn ein Benutzer beispielsweise mit Exchange Online interagiert, kann hier die IP-Adresse aufgezeichnet werden, die Microsoft Exchange vom Benutzer erhält. Dieser Wert ist häufig null. Unterstützt $filter (eq, startswith).
managedServiceIdentity managedIdentity Enthält Informationen zur verwalteten Identität, die für die Anmeldung verwendet wird, einschließlich ihres Typs, der zugehörigen Azure Resource Manager Ressourcen-ID und Informationen zum Verbundtoken. Unterstützt $filter (eq) für msiType.
resourceDisplayName Zeichenfolge Der Name der Ressource, bei der sich der Benutzer angemeldet hat. Unterstützt $filter (eq).
resourceId String Der Anwendungsbezeichner der Ressourcenanwendung, bei der sich der Benutzer angemeldet hat. Unterstützt $filter (eq).
servicePrincipalId Zeichenfolge Die Anwendungs-ID der jeweiligen Dienstprinzipal-instance der für die Anmeldung verwendeten Anwendungs-ID. Dieses Feld wird ausgefüllt, wenn Sie sich mit einer Anwendung anmelden, und unterscheidet sich von der appId Eigenschaft. Unterstützt $filter (eq).
servicePrincipalName Zeichenfolge Der Name der Anwendung, der für die Anmeldung verwendet wird. Dieses Feld wird ausgefüllt, wenn Sie sich mit einer Anwendung anmelden. Unterstützt $filter (eq, startswith).
signInCount Int64 Die Gesamtzahl der Anmeldeereignisse, die in der Zusammenfassung enthalten sind.
status signInStatus Der Anmelde-Status. Enthält den Fehlercode und eine Beschreibung des Fehlers (bei einem Anmeldefehler). Unterstützt $filter (eq) für errorCode.
tenantId Zeichenfolge Die Mandanten-ID des Benutzers, der die Anmeldung initiiert. Unterstützt $filter (eq).
userPrincipalName Zeichenfolge Benutzerprinzipalname des Benutzers, der die Anmeldung initiiert hat. Dieser Wert ist immer in Kleinbuchstaben angegeben. Für Gastbenutzer, deren Werte im Benutzerobjekt in der Regel vor dem Domänenteil enthalten #EXT# , speichert diese Eigenschaft den Wert sowohl in Kleinbuchstaben als auch im Format "true". Während das Benutzerobjekt AdeleVance_fabrikam.com#EXT#@contoso.combeispielsweise speichert, speichern die Anmeldeprotokolle adelevance@fabrikam.com. Unterstützt $filter (eq).

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.summarizedSignIn",
  "id": "String (identifier)",
  "signInCount": "Integer",
  "aggregationDateTime": "String (timestamp)",
  "firstSignInDateTime": "String (timestamp)",
  "userPrincipalName": "String",
  "appId": "String",
  "appDisplayName": "String",
  "ipAddress": "String",
  "conditionalAccessStatus": "String",
  "resourceDisplayName": "String",
  "resourceId": "String",
  "tenantId": "String",
  "servicePrincipalName": "String",
  "servicePrincipalId": "String",
  "status": {
    "@odata.type": "microsoft.graph.signInStatus"
  },
  "managedServiceIdentity": {
    "@odata.type": "microsoft.graph.managedIdentity"
  },
  "agent": {
    "@odata.type": "microsoft.graph.agentic.agentSignIn"
  }
}
  • Last updated on