userRegistrationDetails リソースの種類

名前空間: microsoft.graph

重要

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

ユーザーの認証方法の状態を表します。登録されているメソッドや、ユーザーが登録されていて使用できる機能などが示されます。 たとえば、多要素認証、セルフサービス パスワード リセット、パスワードレス認証などです。 この機能のライセンス要件の詳細については、「 認証方法アクティビティ:権限とライセンス」を参照してください。

エンティティ から継承します。

メソッド

メソッド 戻り値の種類 説明
List userRegistrationDetails コレクション userRegistrationDetails オブジェクトで定義されているユーザーに登録されている認証方法の一覧を取得します。
Get userRegistrationDetails userRegistrationDetails オブジェクトのプロパティと関係を読み取ります。

プロパティ

プロパティ 型 説明
defaultMfaMethod defaultMfaMethodType ユーザーまたは管理者がユーザーに対して多要素認証を実行するための既定として選択した方法。 使用可能な値: none、mobilePhone、alternateMobilePhone、officePhone、microsoftAuthenticatorPush、softwareOneTimePasscode、unknownFutureValue。
id 文字列 Microsoft Entra ID のユーザー オブジェクト識別子。 エンティティから継承 されます。
isAdmin ブール型 ユーザーがテナントで 管理者ロール を持っているかどうかを示します。 この値を使用して、特権アカウントが登録され、可能な認証方法をチェックできます。
isMfaCapable ブール型 ユーザーが多要素認証用の強力な認証方法を登録しているかどうかを示します。 このメソッドは、 認証メソッド ポリシーで許可されている必要があります。 $filter (eq)をサポートしています。
isMfaRegistered ブール型 ユーザーが多要素認証用の強力な認証方法を登録しているかどうかを示します。 このメソッドは、 認証メソッド ポリシーで許可されているとは限りません。 $filter (eq)をサポートしています。
isPasswordlessCapable ブール型 ユーザーが、認証方法ポリシーで許可されているパスワードなしの強力な認証方法 (FIDO2、Windows Hello for Business、Microsoft Authenticator (パスワードレス) を含む) を登録しているかどうかを示します。 $filter (eq)をサポートしています。
isSsprCapable ブール型 ユーザーがセルフサービス パスワード リセットに必要な数の認証方法を登録していて、ユーザーがポリシーによってセルフサービス パスワード リセットを実行できるかどうかを示します。 $filter (eq)をサポートしています。
isSsprEnabled ブール型 ユーザーがポリシーによってセルフサービス パスワード リセットを実行できるかどうかを示します。 ユーザーは、セルフサービス パスワード リセットに必要な数の認証方法を登録していない場合があります。 $filter (eq)をサポートしています。
isSsprRegistered ブール型 ユーザーがセルフサービス パスワード リセットに必要な数の認証方法を登録したかどうかを示します。 ユーザーは、必ずしもポリシーによってセルフサービス パスワード リセットを実行できるとは限りません。 $filter (eq)をサポートしています。
isSystemPreferredAuthenticationMethodEnabled ブール型 システム優先認証方法が有効かどうかを示します。 有効にすると、システムは、ユーザーが登録した認証方法の中から最も安全な認証方法を動的に決定します。 $filter (eq)をサポートしています。
lastUpdatedDateTime DateTimeOffset レポートが最後に更新された日時 (UTC)。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
methodsRegistered String collection 登録されている認証方法のコレクション ( mobilePhone、 email、 passKeyDeviceBound など)。 $filter (eq でany) をサポートします。
systemPreferredAuthenticationMethods String collection 登録済みの第 2 要素認証方法の中で最も安全な認証方法であるとシステムが判断した認証方法のコレクション。 指定できる値は、 push、 oath、 voiceMobile、 voiceAlternateMobile、 voiceOffice、 sms、 none、 unknownFutureValue です。 $filter (eq でany) をサポートします。
userDisplayName String Adele Vance などのユーザーの表示名。 $filter (eq、startsWith) と $orderby をサポートします。
userPreferredMethodForSecondaryAuthentication userDefaultAuthenticationMethod ユーザーが多要素認証を実行するための既定の第 2 要素として選択した方法。 指定できる値は、 push、 oath、 voiceMobile、 voiceAlternateMobile、 voiceOffice、 sms、 none、 unknownFutureValue です。
userPrincipalName String AdeleV@contoso.com などのユーザー プリンシパル名。 $filter (eq、startsWith) と $orderby をサポートします。
userType signInUserType ユーザーがテナントのメンバーかゲストかを識別します。 使用可能な値: member、guest、unknownFutureValue。

リレーションシップ

なし。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.userRegistrationDetails",
  "defaultMfaMethod": "String",
  "id": "String (identifier)",
  "isAdmin": "Boolean",
  "isMfaCapable": "Boolean",
  "isMfaRegistered": "Boolean",
  "isPasswordlessCapable": "Boolean",
  "isSsprCapable": "Boolean",
  "isSsprEnabled": "Boolean",
  "isSsprRegistered": "Boolean",
  "isSystemPreferredAuthenticationMethodEnabled": "Boolean",
  "lastUpdatedDateTime": "String (timestamp)",
  "methodsRegistered": ["String"],
  "systemPreferredAuthenticationMethods": ["String"],
  "userDisplayName": "String",
  "userPreferredMethodForSecondaryAuthentication": "String",
  "userPrincipalName": "String",
  "userType": "String"
}
  • 最終更新: