EmailMethod erstellen
Namespace: microsoft.graph
Legen Sie das emailAuthenticationMethod-Objekt eines Benutzers fest. Die E-Mail-Authentifizierung ist eine Self-Service-Kennwortzurücksetzungsmethode. Ein Benutzer kann nur über eine E-Mail-Authentifizierungsmethode verfügen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.ReadWrite |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | UserAuthenticationMethod.ReadWrite.All | Nicht verfügbar. |
Für delegierte Szenarien, in denen ein Administrator auf einen anderen Benutzer wirkt, benötigt der Administrator mindestens die Microsoft Entra-Rolle"Authentifizierungsadministrator" oder "Privilegierter Authentifizierungsadministrator".
Benutzer können ihrem eigenen Konto keine E-Mail-Authentifizierungsmethode hinzufügen.
HTTP-Anforderung
Fügen Sie dem Konto eines anderen Benutzers eine E-Mail-Authentifizierungsmethode hinzu.
POST /users/{id | userPrincipalName}/authentication/emailMethods
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des emailAuthenticationMethod-Objekts mit der gewünschten E-Mail-Adresse an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen der emailAuthenticationMethod erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
emailAddress | Zeichenfolge | E-Mail-Adresse. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 201 Created
Antwortcode und ein neues emailAuthenticationMethod-Objekt im Antworttext zurück.
Beispiele
Anforderung
POST https://graph.microsoft.com/v1.0/users/kim@contoso.com/authentication/emailMethods
Content-Type: application/json
{
"emailAddress": "kim@contoso.com"
}
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-type: application/json
{
"id": "3ddfcfc8-9383-446f-83cc-3ab9be4be18f",
"emailAddress": "kim@contoso.com"
}