phoneAuthenticationMethod リソースの種類

[アーティクル]
07/22/2024

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ユーザーに登録された電話の表現。このリソースには、電話番号、電話の種類、およびユーザーが SMS 経由でサインインするように電話が構成されているかどうかが含まれます。

電話には、モバイル、代替モバイル、またはオフィスの 3 種類のいずれかがあります。ユーザーは、種類ごとに 1 つの番号を登録でき、代替の携帯電話を追加する前に携帯電話を持っている必要があります。多要素認証 (MFA) またはセルフサービスパスワードリセット (SSPR) に電話を使用する場合、携帯電話は既定で、代替携帯電話はバックアップです。

プライマリ携帯電話は、テナントの設定に応じて、SMS 通話と音声通話の両方に使用できます。

オフィス電話では、SMS メッセージではなく音声通話のみを受信できます。

これは、 authenticationMethod リソースの種類から継承する派生型です。

メソッド

メソッド	戻り値の型	説明
List	phoneAuthenticationMethod	このユーザーのすべての phoneAuthenticationMethod オブジェクトのプロパティとリレーションシップを読み取ります。
Get	phoneAuthenticationMethod	phoneAuthenticationMethod オブジェクトのプロパティとリレーションシップを読み取ります。
追加する	phoneAuthenticationMethod	ユーザーの phoneAuthenticationMethod オブジェクトをCreateします。
Update	phoneAuthenticationMethod	phoneAuthenticationMethod オブジェクトを更新します。
Delete	なし	phoneAuthenticationMethod オブジェクトを削除します。
SMS サインインを無効にする	なし	ユーザーの SMS サインインを無効にします。
SMS サインインを有効にする	なし	ユーザーの SMS サインインを有効にします。

プロパティ

プロパティ	種類	説明
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	SMS サインインに電話を使用する準備ができているかどうか。使用可能な値は、`notSupported`、`notAllowedByPolicy`、、`notEnabled`、`phoneNumberNotUniqueready`、または `notConfigured`です`unknownFutureValue`。

authenticationPhoneType の値

電話には 3 つの種類を指定できます。使用可能な値は次のとおりです。

値	説明
モバイル	SMS 通話や音声通話に使用できるプライマリ携帯電話。
alternateMobile	音声通話にのみ使用できる代替またはバックアップの携帯電話。
オフィス	音声通話にのみ使用できるオフィス電話または固定電話。

authenticationMethodSignInState 値

SMS サインイン状態プロパティは、電話番号が SMS 経由でサインインする準備ができているかどうかに関する情報を提供します。使用可能な値を次に示します。

値	説明
notSupported	この認証方法ではサポートされていないプライマリサインイン - たとえば、サインインは、代替番号ではなく、ユーザーのプライマリモバイル番号でのみ有効にすることができます。
notAllowedByPolicy	このユーザーは、このメソッドをプライマリサインインとして使用するようにポリシーによって有効になっていません。
notConfigured	このユーザーは、このメソッドをプライマリサインインとして使用するようにポリシーによって有効になっていますが、構成するにはさらにアクションを実行する必要があります。
phoneNumberNotUnique	このユーザーは、プライマリサインインとして電話番号を設定しようとしましたが、その番号は一意ではなく、サインイン名として使用できません。
準備	この認証方法は、プライマリサインインで使用する準備が整いました。
notEnabled	このサインイン方法が有効になっていません

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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

次の方法で共有