phoneAuthenticationMethod 资源类型

命名空间:microsoft.graph

表示注册到用户的电话号码和类型,以及该电话号码和类型是否配置为用户通过短信登录。

手机有三种类型之一:移动、备用移动或办公室。 用户可以为每个类型注册一个号码,并且必须在添加备用移动电话之前拥有一个移动电话。 使用手机进行多重身份验证 (MFA) 或自助密码重置 (SSPR) 时,默认为移动电话,备用移动电话为备份。

主移动电话可用于短信和语音呼叫,具体取决于租户设置。

办公电话只能接听语音呼叫,不能接听短信。

这是继承自 authenticationMethod 资源类型的派生类型。

方法

方法 返回类型 Description
List phoneAuthenticationMethod 读取此用户的所有 phoneAuthenticationMethod 对象的属性和关系。
Get phoneAuthenticationMethod 读取用户的 phoneAuthenticationMethod 对象的属性和关系。
添加 phoneAuthenticationMethod 创建用户的 phoneAuthenticationMethod 对象。
更新 无 更新用户的 phoneAuthenticationMethod 对象。
删除 无 删除用户的 phoneAuthenticationMethod 对象。
禁用短信登录 无 关闭用户的短信登录。
启用短信登录 无 为用户启用短信登录。

属性

属性 类型 说明
id String 注册到此用户的此手机的标识符。 只读。

ID 的值为以下值之一:
  • b6332ec1-7057-4abe-9331-3d72feddfe41 - 其中 phoneType 为 alternateMobile。
  • e37fc753-ff3b-4958-9484-eaa9425c82bc - 其中 phoneType 为 office。
  • 3179e48a-750b-4051-897c-87b9720928f7 - 其中 phoneType 为 mobile。
phoneNumber String 要发短信或呼叫进行身份验证的电话号码。 电话号码使用 格式 +{country code} {number}x{extension},扩展名可选。 例如, +1 5555551234 或 +1 5555551234x123 有效。 如果数字与所需格式不匹配,则创建或更新时将拒绝这些数字。
phoneType authenticationPhoneType 此手机的类型。 可能的值为: mobile、 alternateMobile或 office。
smsSignInState authenticationMethodSignInState 手机是否已准备好用于短信登录。 可能的值为:notSupported、、notAllowedByPolicy、notEnabledphoneNumberNotUnique、ready、 或 。 unknownFutureValuenotConfigured

authenticationPhoneType 值

手机可以有三种类型,以下是可能的值。

值 说明
mobile 主要移动电话,可用于短信和语音呼叫。
alternateMobile 备用或备用移动电话,仅适用于语音呼叫。
办公室 办公室电话或座机,仅适用于语音呼叫。

authenticationMethodSignInState 值

SMS 登录状态属性提供有关电话号码是否已准备好通过短信登录的信息。 下面是可能的值。

值 说明
notSupported 此身份验证方法不支持主登录。 例如,只能对用户的主要手机号码启用登录,而不能对备用号码启用登录。
notAllowedByPolicy 策略未允许此用户使用此方法作为主登录。
notConfigured 策略允许此用户使用此方法作为主要登录,但需要采取进一步作来配置它。
phoneNumberNotUnique 此用户尝试将电话号码设置为主要登录,但该号码不唯一,不能用作登录名称。
准备 此身份验证方法已准备好在主登录中使用。
notEnabled 未启用此登录方法

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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