phoneAuthenticationMethod リソースの種類
名前空間: microsoft.graph
ユーザーに登録されている電話番号と種類、およびユーザーが SMS 経由でサインインするように構成されているかどうかを表します。
電話には、モバイル、代替モバイル、またはオフィスの 3 種類のいずれかがあります。 ユーザーは、種類ごとに 1 つの番号を登録でき、代替の携帯電話を追加する前に携帯電話を持っている必要があります。 多要素認証 (MFA) またはセルフサービス パスワード リセット (SSPR) に電話を使用する場合、携帯電話は既定で、代替携帯電話はバックアップです。
プライマリ 携帯電話は、テナントの設定に応じて、SMS 通話と音声通話の両方に使用できます。
オフィス電話では、SMS メッセージではなく音声通話のみを受信できます。
これは、 authenticationMethod リソースの種類から継承する派生型です。
メソッド
メソッド | 戻り値の型 | 説明 |
---|---|---|
phoneMethods を一覧表示する | phoneAuthenticationMethod | このユーザーのすべての phoneAuthenticationMethod オブジェクトのプロパティとリレーションシップを読み取ります。 |
phoneAuthenticationMethod を取得する | phoneAuthenticationMethod | ユーザーの phoneAuthenticationMethod オブジェクトのプロパティとリレーションシップを読み取ります。 |
phoneMethod を作成する | phoneAuthenticationMethod | ユーザーの phoneAuthenticationMethod オブジェクトを作成します。 |
phoneAuthenticationMethod を更新する | なし | ユーザーの phoneAuthenticationMethod オブジェクトを更新します。 |
phoneAuthenticationMethod を削除する | なし | ユーザーの phoneAuthenticationMethod オブジェクトを削除します。 |
SMS サインインを無効にする | なし | ユーザーの SMS サインインを無効にします。 |
SMS サインインを有効にする | なし | ユーザーの SMS サインインを有効にします。 |
プロパティ
プロパティ | 型 | 説明 |
---|---|---|
id | String | このユーザーに登録されているこの電話の識別子。 読み取り専用。 ID の値は、次のいずれかです。
|
phoneNumber | String | テキストまたは認証を呼び出す電話番号。 電話番号は、 形式 +{country code} {number}x{extension} を使用し、拡張子は省略可能です。 たとえば、 +1 5555551234 または +1 5555551234x123 が有効です。 数値が必要な形式と一致しない場合、作成または更新時に拒否されます。 |
phoneType | authenticationPhoneType | この電話の種類。 使用可能な値は、mobile 、alternateMobile 、office です。 |
smsSignInState | authenticationMethodSignInState | SMS サインインに電話を使用する準備ができているかどうか。 使用可能な値は、notSupported 、notAllowedByPolicy 、、notEnabled 、phoneNumberNotUnique ready 、または notConfigured ですunknownFutureValue 。 |
authenticationPhoneType の値
電話には 3 つの種類を指定できます。使用可能な値は次のとおりです。
値 | 説明 |
---|---|
モバイル | SMS 通話や音声通話に使用できるプライマリ携帯電話。 |
alternateMobile | 音声通話にのみ使用できる代替またはバックアップの携帯電話。 |
オフィス | 音声通話にのみ使用できるオフィス電話または固定電話。 |
authenticationMethodSignInState 値
SMS サインイン状態プロパティは、電話番号が SMS によるサインインの準備ができているかどうかに関する情報を提供します。 使用可能な値を次に示します。
値 | 説明 |
---|---|
notSupported | この認証方法では、プライマリ サインインはサポートされていません。 たとえば、サインインはユーザーのプライマリ モバイル番号でのみ有効にできますが、代替番号では有効にできません。 |
notAllowedByPolicy | このユーザーは、このメソッドをプライマリ サインインとして使用するようにポリシーによって有効になっていません。 |
notConfigured | このユーザーは、このメソッドをプライマリ サインインとして使用するようにポリシーによって有効になっていますが、構成するにはさらにアクションを実行する必要があります。 |
phoneNumberNotUnique | このユーザーは、プライマリ サインインとして電話番号を設定しようとしましたが、その番号は一意ではなく、サインイン名として使用できません。 |
準備 | この認証方法は、プライマリ サインインで使用する準備が整いました。 |
notEnabled | このサインイン 方法が有効になっていません |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"id": "String (identifier)",
"phoneNumber": "String",
"phoneType": "string",
"smsSignInState": "string"
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示