Freigeben über


userCredentialUsageDetails-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.

Wichtig

Die API zur Verwendung von Benutzeranmeldeinformationen ist veraltet und gibt am 1. August 2025 keine Daten mehr zurück. Verwenden Sie stattdessen die neue Zusammenfassungs-API für Benutzerereignisse .

Stellt die Verwendung der Self-Service-Kennwortzurücksetzung für einen bestimmten Mandanten dar. Details umfassen Benutzerinformationen, status des Zurücksetzens und den Grund für den Fehler. Weitere Informationen zu den Lizenzanforderungen für dieses Feature finden Sie unter Authentifizierungsmethodenaktivität: Berechtigungen und Lizenzen.

Methoden

Methode Rückgabetyp Beschreibung
List userCredentialUsageDetails Lesen von Eigenschaften und Beziehungen eines userCredentialUsageDetails-Objekts.

Eigenschaften

Eigenschaft Typ Beschreibung
authMethod usageAuthMethod Stellt die Authentifizierungsmethode dar, die der Benutzer verwendet hat. Die möglichen Werte sind: email, mobileSMS, mobileCall, officePhone, securityQuestion, , appCodealternateMobileCallunknownFutureValueappPasswordexternalAuthMethodfidohardwareOneTimePasscodewindowsHelloForBusinesstemporaryAccessPassmacOsSecureEnclaveKeypassKeyDeviceBoundAuthenticatormicrosoftAuthenticatorPasswordlessappNotificationpassKeyDeviceBound, . passKeySyncedpassKeyDeviceBoundWindowsHellosoftwareOneTimePasscodemicrosoftAuthenticatorPushmobilePhonesmsalternateMobilePhonefido2SecurityKeyoneTimePasscode Verwenden Sie den AnforderungsheaderPrefer: include-unknown-enum-members, um die folgenden Werte aus dieser verwertbaren Enumeration abzurufen: externalAuthMethod , hardwareOneTimePasscode , , microsoftAuthenticatorPasswordlesswindowsHelloForBusiness , temporaryAccessPass , macOsSecureEnclaveKey , passKeyDeviceBoundWindowsHellopassKeySyncedoneTimePasscodefido2SecurityKeyalternateMobilePhonemobilePhonesoftwareOneTimePasscodesmspassKeyDeviceBoundpassKeyDeviceBoundAuthenticatormicrosoftAuthenticatorPush .
eventDateTime DateTimeOffset Der Typ „Zeitstempel“ stellt die Datums- und Uhrzeitinformationen im Format der ISO 8601 dar und gibt immer die UTC an. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
failureReason Zeichenfolge Gibt die Fehlerursache für den entsprechenden Zurücksetzungs- oder Registrierungsworkflow an.
Merkmal featureType Die möglichen Werte sind: registration, reset, unknownFutureValue.
id Zeichenfolge Schreibgeschützt. Der eindeutige Bezeichner für die Aktivität. Schreibgeschützt.
isSuccess Boolean Gibt den Erfolg oder Fehler des Workflows an.
userDisplayName String Benutzername des Benutzers, der den Zurücksetzungs- oder Registrierungsworkflow ausführt.
userPrincipalName Zeichenfolge Der Benutzerprinzipalname des Benutzers, der den Zurücksetzungs- oder Registrierungsworkflow ausführt.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "id" : "String",
  "feature":"string",
  "userPrincipalName":"String",
  "userDisplayName": "String",
  "isSuccess" : true,
  "authMethod": "string",
  "failureReason": "String",
  "eventDateTime" : "DateTimeOffset"
}