userRegistrationDetails リソースの種類

名前空間: microsoft.graph

重要

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

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

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

メソッド

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

プロパティ

プロパティ	型	説明
defaultMfaMethod	defaultMfaMethodType	ユーザーまたは管理者が、ユーザーに対して多要素認証を実行するために既定で選択した方法。 使用可能な値: none、mobilePhone、alternateMobilePhone、officePhone、microsoftAuthenticatorPush、softwareOneTimePasscode、unknownFutureValue。
id	String	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	、、などmobilePhoneemailpassKeyDeviceBound、登録されている認証方法のコレクション。 をサポートします $filter (any を使用 eq)。
systemPreferredAuthenticationMethods	String collection	第 2 要素認証の登録済み方法の中で最も安全な認証方法であるとシステムが判断した認証方法のコレクション。 可能な値は、push、oath、voiceMobile、voiceAlternateMobile、voiceOffice、sms、none、unknownFutureValue です。 をサポートします $filter (any を使用 eq)。
userDisplayName	String	ユーザーの表示名 (など Adele Vance)。 (、startsWith) と を$orderbyサポートします$filter。eq
userPreferredMethodForSecondaryAuthentication	userDefaultAuthenticationMethod	ユーザーが多要素認証を実行するための既定の第 2 要素として選択した方法。 可能な値は、push、oath、voiceMobile、voiceAlternateMobile、voiceOffice、sms、none、unknownFutureValue です。
userPrincipalName	String	ユーザー プリンシパル名 (など AdeleV@contoso.com)。 (、startsWith) と を$orderbyサポートします$filter。eq
userType	signInUserType	ユーザーがテナントのメンバーかゲストかを識別します。 使用可能な値: member、guest、unknownFutureValue。

リレーションシップ

なし。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.userRegistrationDetails",
  "defaultMethod": "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"
}