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

Definiert Authentifizierungsmethoden und die Benutzer, die sie zum Anmelden und Ausführen der mehrstufigen Authentifizierung (MFA) in Microsoft Entra ID verwenden dürfen.

Methoden

Methode	Rückgabetyp	Beschreibung
Get	authenticationMethodsPolicy	Liest die Eigenschaften und Beziehungen eines authenticationMethodsPolicy-Objekts .
Update	authenticationMethodsPolicy	Aktualisieren sie die Eigenschaften eines authenticationMethodsPolicy-Objekts .

Eigenschaften

Eigenschaft	Typ	Beschreibung
description	Zeichenfolge	Eine Beschreibung der Richtlinie.
displayName	String	Der Name der Richtlinie
id	Zeichenfolge	Der Bezeichner der Richtlinie. Geerbt von entity.
lastModifiedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der letzten Aktualisierung der Richtlinie.
policyVersion	Zeichenfolge	Die verwendete Version der Richtlinie.
policyMigrationState	authenticationMethodsPolicyMigrationState	Der Status der Migration der Richtlinie für Authentifizierungsmethoden aus den Legacyrichtlinien für mehrstufige Authentifizierung und Self-Service-Kennwortzurücksetzung (Self-Service Password Reset, SSPR). Die folgenden Werte sind möglich: premigration – bedeutet, dass die Richtlinie für Authentifizierungsmethoden nur für die Authentifizierung verwendet wird, legacy-Richtlinien eingehalten werden. migrationInProgress – bedeutet, dass die Richtlinie für Authentifizierungsmethoden sowohl für die Authentifizierung als auch für SSPR verwendet wird. Legacyrichtlinien werden beachtet. migrationComplete – bedeutet, dass die Richtlinie für Authentifizierungsmethoden für die Authentifizierung und SSPR verwendet wird. Legacyrichtlinien werden ignoriert. unknownFutureValue – Wert des Sentinelwerts für vervolvierbare Enumerationen. Nicht verwenden.
reconfirmationInDays	Int32	Tage bevor der Benutzer aufgefordert wird, seine Methode erneut zu bestätigen.
registrationEnforcement	registrationEnforcement	Erzwingen Sie die Registrierung zum Anmeldezeitpunkt. Diese Eigenschaft kann verwendet werden, um Benutzer daran zu erinnern, gezielte Authentifizierungsmethoden einzurichten.
reportSuspiciousActivitySettings	reportSuspiciousActivitySettings	Ermöglichen Sie Benutzern, unerwartete Sprachanrufe oder Benachrichtigungsaufforderungen bei der mehrstufigen Authentifizierung als verdächtig zu melden.
systemCredentialPreferences	systemCredentialPreferences	Fordern Sie Benutzer mit ihren bevorzugten Anmeldeinformationen für die mehrstufige Authentifizierung auf.

Beziehungen

Beziehung	Typ	Beschreibung
authenticationMethodConfigurations	authenticationMethodConfiguration-Sammlung	Stellt die Einstellungen für jede Authentifizierungsmethode dar. Wird bei GET /policies/authenticationMethodsPolicy automatisch erweitert.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.authenticationMethodsPolicy",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "policyVersion": "String",
  "registrationEnforcement": {
    "@odata.type": "microsoft.graph.registrationEnforcement"
  },
    "reportSuspiciousActivitySettings": {
    "@odata.type": "microsoft.graph.reportSuspiciousActivitySettings"
  },
  "systemCredentialPreferences": {
    "@odata.type": "microsoft.graph.systemCredentialPreferences"
  }
}