Auflisten von userRegistrationDetails
Namespace: microsoft.graph
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 |
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer Besitzer oder Mitglied der Gruppe sein oder einer unterstützten Microsoft Entra-Rolle oder einer benutzerdefinierten Rolle mit einer unterstützten Rollenberechtigung zugewiesen sein. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.
- 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/v1.0/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/v1.0/$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"
],
"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": [],
"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"
],
"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