Tipo de recurso phoneAuthenticationMethod

Espacio de nombres: microsoft.graph

Representa un número de teléfono y un tipo que está registrado para un usuario y si está configurado para que el usuario inicie sesión a través de SMS.

Un teléfono tiene uno de los tres tipos: móvil, móvil alternativo u oficina. Un usuario puede tener un número registrado para cada tipo y debe tener un teléfono móvil antes de agregar un teléfono móvil alternativo. Cuando se usa un teléfono para la autenticación multifactor (MFA) o el autoservicio de restablecimiento de contraseña (SSPR), el teléfono móvil es el valor predeterminado y el teléfono móvil alternativo es la copia de seguridad.

Los teléfonos móviles principales se pueden usar para llamadas SMS y de voz, en función de la configuración del inquilino.

Un teléfono de la oficina solo puede recibir llamadas de voz, no mensajes SMS.

Se trata de un tipo derivado que hereda del tipo de recurso authenticationMethod .

Métodos

Método	Tipo de valor devuelto	Descripción
Enumerar phoneMethods	phoneAuthenticationMethod	Lea las propiedades y las relaciones de todos los objetos phoneAuthenticationMethod de este usuario.
Obtener phoneAuthenticationMethod	phoneAuthenticationMethod	Lea las propiedades y las relaciones del objeto phoneAuthenticationMethod para un usuario.
Crear phoneMethod	phoneAuthenticationMethod	Cree el objeto phoneAuthenticationMethod de un usuario.
Actualizar phoneAuthenticationMethod	Ninguno	Actualice el objeto phoneAuthenticationMethod para un usuario.
Eliminar phoneAuthenticationMethod	Ninguno	Elimine el objeto phoneAuthenticationMethod para un usuario.
Deshabilitar el inicio de sesión de SMS	Ninguno	Desactivar el inicio de sesión de SMS para un usuario.
Habilitación del inicio de sesión de SMS	Ninguno	Active el inicio de sesión de SMS para un usuario.

Propiedades

Propiedad	Tipo	Descripción
id	Cadena	Identificador de este teléfono registrado para este usuario. Solo lectura. El valor de ID es uno de los siguientes: b6332ec1-7057-4abe-9331-3d72feddfe41 - donde phoneType es alternateMobile. e37fc753-ff3b-4958-9484-eaa9425c82bc - donde phoneType es office. 3179e48a-750b-4051-897c-87b9720928f7 - donde phoneType es mobile.
phoneNumber	Cadena	Número de teléfono al que se va a enviar un mensaje de texto o a la llamada para la autenticación. Los números de teléfono usan el formato +{country code} {number}x{extension}, con la extensión opcional. Por ejemplo, +1 5555551234 o +1 5555551234x123 son válidos. Los números se rechazan al crear o actualizar si no coinciden con el formato necesario.
phoneType	authenticationPhoneType	Tipo de este teléfono. Los valores posibles son mobile, alternateMobile o office.
smsSignInState	authenticationMethodSignInState	Si un teléfono está listo para usarse para el inicio de sesión por SMS o no. Los valores posibles son: notSupported, notAllowedByPolicy, notEnabled, phoneNumberNotUnique, readyo notConfigured, unknownFutureValue.

valores authenticationPhoneType

Los teléfonos pueden ser de tres tipos, los siguientes son los valores posibles.

Valor	Descripción
móvil	Un teléfono móvil principal, que se puede usar para sms y llamadas de voz.
alternateMobile	Un teléfono móvil alternativo o de copia de seguridad, que solo se puede usar para llamadas de voz.
oficina	Teléfono de oficina o teléfono fijo, utilizable solo para llamadas de voz.

valores authenticationMethodSignInState

La propiedad de estado de inicio de sesión de SMS proporciona información sobre si un número de teléfono está listo o no para iniciar sesión a través de SMS. A continuación se muestran los valores posibles.

Valor	Descripción
notSupported	El inicio de sesión principal no se admite en este método de autenticación. Por ejemplo, el inicio de sesión solo se puede habilitar en el número de móvil principal de un usuario, pero no en el número alternativo.
notAllowedByPolicy	La directiva no habilita a este usuario para usar este método como inicio de sesión principal.
notConfigured	La directiva habilita a este usuario para usar este método como inicio de sesión principal, pero debe realizar más acciones para configurarlo.
phoneNumberNotUnique	Este usuario intentó configurar un número de teléfono como inicio de sesión principal, pero el número no era único y no se puede usar como nombre de inicio de sesión.
Listo	Este método de autenticación está listo para su uso en el inicio de sesión principal.
notEnabled	Este método de inicio de sesión no está habilitado

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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