type de ressource phoneAuthenticationMethodphoneAuthenticationMethod resource type

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported.

Représentation d’un téléphone enregistré auprès d’un utilisateur.A representation of a phone registered to a user. Cette ressource inclut le numéro de téléphone, le type de téléphone et indique si le téléphone est configuré pour que l’utilisateur se connecte via SMS.This resource includes the phone number, the phone type, and whether the phone is configured for the user to sign in via SMS.

Un téléphone est doté de l’un des trois types suivants : mobile, autre mobile ou Office.A phone has one of three types: mobile, alternate mobile, or office. Un utilisateur peut avoir un numéro enregistré pour chaque type, et doit avoir un téléphone mobile avant l’ajout d’un autre téléphone mobile.A user can have one number registered for each type, and must have a mobile phone before an alternate mobile phone is added. Lors de l’utilisation d’un téléphone pour l’authentification multifacteur (MFA) ou le mode de réinitialisation du mot de passe en libre-service (SSPR), le téléphone mobile est l’option par défaut et le téléphone mobile auxiliaire est la sauvegarde.When using a phone for multi-factor authentication (MFA) or self-service password reset (SSPR), the mobile phone is the default and the alternate mobile phone is the backup.

Les téléphones mobiles peuvent être utilisés pour les appels SMS et vocaux, en fonction des paramètres du client.Mobile phones can be used for both SMS and voice calls, depending on the tenant settings.

Un téléphone Office ne peut recevoir que des appels vocaux, et non des messages SMS.An office phone can only receive voice calls, not SMS messages.

La propriété de l’état de connexion SMS indique si un numéro de téléphone est prêt à se connecter via SMS.The SMS sign-in state property gives information about whether or not a phone number is ready to sign in via SMS. Les valeurs possibles sont les suivantes.The following are the possible values.

ValeurValue DescriptionDescription
notSupported La connexion principale n’est pas prise en charge sur cette méthode d’authentification-par exemple, la connexion ne peut être activée que sur le numéro de téléphone principal d’un utilisateur, et non sur l’autre numéro.Primary sign-in not supported on this authentication method - for example, sign-in can be enabled only on a user's primary mobile number, not the alternate number.
notAllowedByPolicy Cet utilisateur n’est pas autorisé par la stratégie à utiliser cette méthode comme connexion principale.This user isn't enabled by policy to use this method as a primary sign-in.
notConfigured Cet utilisateur est activé par la stratégie pour utiliser cette méthode en tant que connexion principale, mais doit prendre des mesures supplémentaires pour le configurer.This user is enabled by policy to use this method as primary sign-in but needs to take additional action to configure it.
phoneNumberNotUnique Cet utilisateur a tenté de configurer un numéro de téléphone comme connexion principale, mais ce numéro n’était pas unique et ne peut pas être utilisé comme nom de connexion.This user attempted to set up a phone number as primary sign-in but the number was not unique and can't be used as a sign-in name.
ready Cette méthode d’authentification est prête à être utilisée dans la connexion principale.This authentication method is ready for use in primary sign-in.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
ListList phoneAuthenticationMethodphoneAuthenticationMethod Lit les propriétés et relations de tous les objets phoneAuthenticationMethod de cet utilisateur.Read properties and relationships of all of this user's phoneAuthenticationMethod objects.
GetGet phoneAuthenticationMethodphoneAuthenticationMethod Lit les propriétés et relations de l’objet phoneAuthenticationMethod.Read properties and relationships of phoneAuthenticationMethod object.
UpdateUpdate phoneAuthenticationMethodphoneAuthenticationMethod Mettez à jour l’objet phoneAuthenticationMethod.Update phoneAuthenticationMethod object.
SupprimerDelete AucuneNone Supprimez l’objet phoneAuthenticationMethod.Delete phoneAuthenticationMethod object.
Désactiver la connexion SMSDisable SMS signin NéantNone Désactivez la connexion à SMS pour un utilisateur.Turn off SMS sign-in for a user.
Activer la connexion SMSEnable SMS signin NéantNone Activez la connexion à SMS pour un utilisateur.Turn on SMS sign-in for a user.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
idid ChaîneString Identificateur de ce téléphone enregistré pour cet utilisateur.The identifier of this phone registered to this user. En lecture seule.Read-only.
phoneNumberphoneNumber StringString Numéro de téléphone à texte ou appel pour authentification.The phone number to text or call for authentication. Les numéros de téléphone utilisent le format<« +> <numéro>de<code>du pays x », avec une extension facultative.Phone numbers use the format "+<country code> <number>x<extension>", with extension optional. Par exemple, + 1 5555551234 ou + 1 5555551234x123 sont valides.For example, +1 5555551234 or +1 5555551234x123 are valid. Les numéros sont rejetés lors de la création ou de la mise à jour s’ils ne correspondent pas au format requis.Numbers are rejected when creating/updating if they do not match the required format.
phoneTypephoneType stringstring Type de ce téléphone.The type of this phone. Les valeurs possibles sont mobileles alternateMobilesuivantes : office,, ou.Possible values are: mobile, alternateMobile, or office.
smsSignInStatesmsSignInState stringstring Si un téléphone est prêt à être utilisé pour la connexion à SMS ou non.Whether a phone is ready to be used for SMS sign-in or not. Les valeurs possibles sont notSupportedles notAllowedByPolicysuivantes notEnabled: phoneNumberNotUnique, ready,, notConfigured, ou.Possible values are: notSupported, notAllowedByPolicy, notEnabled, phoneNumberNotUnique, ready, or notConfigured.

RelationsRelationships

Aucun.None.

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.The following is a JSON representation of the resource.

{
  "id": "String (identifier)",
  "phoneNumber": "String",
  "phoneType": "string",
  "smsSignInState": "string"
}