phoneAuthenticationMethod 资源类型
命名空间：microsoft.graph
表示注册到用户的电话号码和类型，以及该电话号码和类型是否配置为用户通过短信登录。
手机有三种类型之一：移动、备用移动或办公室。 用户可以为每个类型注册一个号码，并且必须在添加备用移动电话之前拥有一个移动电话。 使用手机进行多重身份验证 (MFA) 或自助密码重置 (SSPR) 时，默认为移动电话，备用移动电话为备份。
主移动电话可用于短信和语音呼叫，具体取决于租户设置。
办公电话只能接听语音呼叫，不能接听短信。
这是继承自 authenticationMethod 资源类型的派生类型。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | phoneAuthenticationMethod | 读取此用户的所有 phoneAuthenticationMethod 对象的属性和关系。 |
| Get | phoneAuthenticationMethod | 读取用户的 phoneAuthenticationMethod 对象的属性和关系。 |
| 添加 | phoneAuthenticationMethod | Create用户的手机AuthenticationMethod 对象。 |
| 更新 | 无 | 更新用户的 phoneAuthenticationMethod 对象。 |
| 删除 | 无 | 删除用户的 phoneAuthenticationMethod 对象。 |
| 禁用短信登录 | 无 | 关闭用户的短信登录。 |
| 启用短信登录 | 无 | 为用户启用短信登录。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 注册到此用户的此手机的标识符。 此为只读属性。 ID 的值为以下值之一：
|
| 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"
}