Auflisten von userRegistrationDetails
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.
Ruft eine Liste der Authentifizierungsmethoden ab, die für einen Benutzer registriert sind, wie im userRegistrationDetails-Objekt definiert. Diese Methode funktioniert nicht für deaktivierte Benutzer.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | AuditLog.Read.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | AuditLog.Read.All |
Für delegierte Szenarien muss der aufrufende Benutzer mindestens über eine der folgenden Microsoft Entra-Rollen verfügen:
- Berichteleser
- Sicherheitsleseberechtigter
- Sicherheitsadministrator
- Globaler Leser
HTTP-Anforderung
GET /reports/authenticationMethods/userRegistrationDetails
Optionale Abfrageparameter
Diese Methode unterstützt den $filter
OData-Abfrageparameter , um die Antwort anzupassen. Sie können auf eine oder mehrere der folgenden Eigenschaften der UserRegistrationDetails-Ressource anwenden$filter
.
Eigenschaft | Beschreibung | Beispiel |
---|---|---|
isMfaCapable | Filtern Sie nach Benutzern, die bereit sind, die Kennwortzurücksetzung oder mehrstufige Authentifizierung (Multi-Factor Authentication, MFA) durchzuführen. Unterstützte Filteroperatoren: eq . |
/reports/authenticationMethods/userRegistrationDetails?$filter=isMfaCapable eq true |
isMfaRegistered | Filtern Sie nach Benutzern, die für MFA registriert sind. Unterstützte Filteroperatoren sind: eq . |
/reports/authenticationMethods/userRegistrationDetails?$filter=isMfaRegistered eq true |
isSsprEnabled | Filtern Sie nach Benutzern, die für SSPR aktiviert wurden. Unterstützte Filteroperatoren sind: eq . |
/reports/authenticationMethods/userRegistrationDetails?$filter=isSsprEnabled eq true . |
isSsprRegistered | Filtern Sie nach Benutzern, die sich für die Self-Service-Kennwortzurücksetzung (SSPR) registriert haben. Unterstützte Filteroperatoren sind: eq . |
/reports/authenticationMethods/userRegistrationDetails?$filter=isSsprRegistered eq true |
methodsRegistered | Filtern Sie nach den Authentifizierungsmethoden, die während der Registrierung verwendet werden. Unterstützte Filteroperatoren sind: eq . |
/reports/authenticationMethods/userRegistrationDetails?$filter=methodsRegistered/any(x:x eq 'email') |
userDisplayName | Filtern Sie nach Benutzername. Unterstützte Filteroperatoren sind: eq und startswith() . Unterstützt Die Groß-/Kleinschreibung wird nicht beachtet. |
/reports/authenticationMethods/userRegistrationDetails?$filter=userDisplayName eq 'Contoso' |
userPrincipalName | Filtern Sie nach Dem Namen des Benutzerprinzipals. Unterstützte Filteroperatoren sind: eq und startswith() . Unterstützt Die Groß-/Kleinschreibung wird nicht beachtet. |
/reports/authenticationMethods/userRegistrationDetails?$filter=userPrincipalName eq 'Contoso' |
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und eine Auflistung von userRegistrationDetails-Objekten im Antworttext zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/reports/authenticationMethods/userRegistrationDetails
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#reports/authenticationMethods/userRegistrationDetails",
"value": [
{
"id": "86462606-fde0-4fc4-9e0c-a20eb73e54c6",
"userPrincipalName": "AlexW@Contoso.com",
"userDisplayName": "Alex Wilber",
"isAdmin": false,
"isSsprRegistered": false,
"isSsprEnabled": false,
"isSsprCapable": false,
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
"methodsRegistered": [
"microsoftAuthenticatorPush",
"softwareOneTimePasscode"
],
"defaultMfaMethod": "microsoftAuthenticatorPush",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [
"push"
],
"userPreferredMethodForSecondaryAuthentication": "push",
"userType": "member"
},
{
"id": "c6ad1942-4afa-47f8-8d48-afb5d8d69d2f",
"userPrincipalName": "AllanD@Contoso.com",
"userDisplayName": "Allan Deyoung",
"isAdmin": false,
"isSsprRegistered": false,
"isSsprEnabled": false,
"isSsprCapable": false,
"isMfaRegistered": false,
"isMfaCapable": false,
"isPasswordlessCapable": false,
"lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
"methodsRegistered": [],
"defaultMfaMethod": "",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [],
"userPreferredMethodForSecondaryAuthentication": "",
"userType": "guest"
},
{
"id": "c8096958-797c-44fa-8fde-a6fb62567cf0",
"userPrincipalName": "BiancaP@Contoso.com",
"userDisplayName": "Bianca Pisani",
"isAdmin": false,
"isSsprRegistered": true,
"isSsprEnabled": false,
"isSsprCapable": false,
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
"methodsRegistered": [
"mobilePhone",
"microsoftAuthenticatorPush",
"softwareOneTimePasscode"
],
"defaultMfaMethod": "mobilePhone",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [
"push"
],
"userPreferredMethodForSecondaryAuthentication": "voiceMobile",
"userType": "member"
}
]
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für