phoneAuthenticationMethod-Ressourcentyp

Namespace: microsoft.graph

Stellt eine Telefonnummer und einen Typ dar, der für einen Benutzer registriert ist, und gibt an, ob er für die Anmeldung des Benutzers per SMS konfiguriert ist.

Ein Telefon verfügt über einen von drei Typen: mobil, alternativ mobil oder büro. Ein Benutzer kann eine Nummer für jeden Typ registriert haben und muss über ein Mobiltelefon verfügen, bevor ein alternatives Mobiltelefon hinzugefügt wird. Wenn Sie ein Telefon für die mehrstufige Authentifizierung (Multi-Factor Authentication, MFA) oder die Self-Service-Kennwortzurücksetzung (Self-Service Password Reset, SSPR) verwenden, ist das Mobiltelefon die Standardeinstellung, und das alternative Mobiltelefon ist die Sicherung.

Primäre Mobiltelefone können abhängig von den Mandanteneinstellungen sowohl für SMS- als auch für Sprachanrufe verwendet werden.

Ein Bürotelefon kann nur Sprachanrufe empfangen, keine SMS-Nachrichten.

Dies ist ein abgeleiteter Typ, der vom Ressourcentyp authenticationMethod erbt.

Methoden

Methode Rückgabetyp Beschreibung
List phoneAuthenticationMethod Liest die Eigenschaften und Beziehungen aller phoneAuthenticationMethod-Objekte dieses Benutzers.
Get phoneAuthenticationMethod Liest Eigenschaften und Beziehungen des phoneAuthenticationMethod-Objekts für einen Benutzer.
Add phoneAuthenticationMethod Create das phoneAuthenticationMethod-Objekt eines Benutzers.
Update Keine Aktualisieren Sie das phoneAuthenticationMethod-Objekt für einen Benutzer.
Delete Keine Löschen Sie das phoneAuthenticationMethod-Objekt für einen Benutzer.
Sms-Anmeldung deaktivieren Keine Deaktivieren Sie die SMS-Anmeldung für einen Benutzer.
Aktivieren der SMS-Anmeldung Keine Aktivieren Sie die SMS-Anmeldung für einen Benutzer.

Eigenschaften

Eigenschaft Typ Beschreibung
id Zeichenfolge Der Bezeichner dieses Telefons, das für diesen Benutzer registriert ist. Schreibgeschützt.

Der Wert von ID ist einer der folgenden:
  • b6332ec1-7057-4abe-9331-3d72feddfe41 – wobei phoneType ist alternateMobile.
  • e37fc753-ff3b-4958-9484-eaa9425c82bc – wobei phoneType ist office.
  • 3179e48a-750b-4051-897c-87b9720928f7 – wobei phoneType ist mobile.
PhoneNumber Zeichenfolge Die Telefonnummer, die per SMS gesendet oder zur Authentifizierung angerufen werden soll. Telefonnummern verwenden das Format +{country code} {number}x{extension}, mit optionaler Durchwahl. Beispielsweise +1 5555551234 sind oder +1 5555551234x123 gültig. Zahlen werden beim Erstellen oder Aktualisieren abgelehnt, wenn sie nicht mit dem erforderlichen Format übereinstimmen.
phoneType authenticationPhoneType Der Typ dieses Telefons. Mögliche Werte: mobile, alternateMobile oder office.
smsSignInState authenticationMethodSignInState Gibt an, ob ein Telefon für die SMS-Anmeldung bereit ist oder nicht. Mögliche Werte sind: notSupported, notAllowedByPolicy, , phoneNumberNotUniquenotEnabled, readyoder notConfigured. unknownFutureValue

authenticationPhoneType-Werte

Telefone können von drei Typen sein. Die folgenden Werte sind möglich.

Wert Beschreibung
Mobil Ein primäres Mobiltelefon, das für SMS- und Sprachanrufe verwendet werden kann.
alternateMobile Ein alternatives oder backup-Mobiltelefon, das nur für Sprachanrufe verwendet werden kann.
Büro Ein Bürotelefon oder Festnetztelefon, das nur für Sprachanrufe verwendet werden kann.

authenticationMethodSignInState-Werte

Die Eigenschaft SMS-Anmeldezustand gibt Informationen darüber an, ob eine Telefonnummer für die Anmeldung per SMS bereit ist. Im Folgenden sind die möglichen Werte aufgeführt.

Wert Beschreibung
Notsupported Die primäre Anmeldung wird für diese Authentifizierungsmethode nicht unterstützt. Beispielsweise kann die Anmeldung nur für die primäre Mobiltelefonnummer eines Benutzers, aber nicht für die alternative Nummer aktiviert werden.
notAllowedByPolicy Dieser Benutzer ist durch die Richtlinie nicht für die Verwendung dieser Methode als primäre Anmeldung aktiviert.
notConfigured Dieser Benutzer wird durch die Richtlinie für die Verwendung dieser Methode als primäre Anmeldung aktiviert, muss aber weitere Maßnahmen ergreifen, um sie zu konfigurieren.
phoneNumberNotUnique Dieser Benutzer hat versucht, eine Telefonnummer als primäre Anmeldung einzurichten, aber die Nummer war nicht eindeutig und kann nicht als Anmeldename verwendet werden.
Bereit Diese Authentifizierungsmethode kann bei der primären Anmeldung verwendet werden.
notEnabled Diese Anmeldemethode ist nicht aktiviert.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.phoneAuthenticationMethod",
  "id": "String (identifier)",
  "phoneNumber": "String",
  "phoneType": "string",
  "smsSignInState": "string"
}