userRegistrationDetails 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示用户的身份验证方法的状态，包括注册了哪些方法以及用户已注册和能够使用的功能。 例如，多重身份验证、自助式密码重置和无密码身份验证。 有关此功能的许可证要求的详细信息，请参阅 身份验证方法活动：权限和许可证。

继承自 entity。

Methods

方法	返回类型	说明
列出 userRegistrationDetails	userRegistrationDetails 集合	获取为 userRegistrationDetails 对象中定义的用户注册的身份验证方法列表。
获取 userRegistrationDetails	userRegistrationDetails	读取 userRegistrationDetails 对象的属性和关系。

属性

属性	类型	说明
defaultMfaMethod	defaultMfaMethodType	用户或管理员选择作为默认用户执行多重身份验证的方法。 可取值包括：none、mobilePhone、alternateMobilePhone、officePhone、microsoftAuthenticatorPush、softwareOneTimePasscode、unknownFutureValue。
id	String	Microsoft Entra ID中的用户对象标识符。 继承自 entity。
isAdmin	布尔值	指示用户在租户中是否具有 管理员角色 。 此值可用于检查特权帐户已注册且能够使用的身份验证方法。
isMfaCapable	布尔值	指示用户是否已注册多重身份验证的强身份验证方法。 身份验证方法策略必须允许该方法。 支持 $filter（eq）。
isMfaRegistered	布尔值	指示用户是否已注册多重身份验证的强身份验证方法。 身份验证方法策略可能不一定允许该方法。 支持 $filter（eq）。
isPasswordlessCapable	布尔值	指示用户是否已注册无密码强身份验证方法 (包括 FIDO2、Windows Hello 企业版 和 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 日午夜 UTC 为 2014-01-01T00:00:00Z。
methodsRegistered	字符串集合	注册的身份验证方法的集合，例如 mobilePhone、 email、 passKeyDeviceBound。 支持 $filter 使用) 进行 anyeq (。
systemPreferredAuthenticationMethods	字符串集合	系统确定为已注册的第二因素身份验证方法中最安全的身份验证方法的集合。 可取值为：push、oath、voiceMobile、voiceAlternateMobile、voiceOffice、sms、none、unknownFutureValue。 支持 $filter 使用) 进行 anyeq (。
userDisplayName	String	用户显示名称，例如 Adele Vance。 支持 $filter (eq、 startsWith) 和 $orderby。
userPreferredMethodForSecondaryAuthentication	userDefaultAuthenticationMethod	用户选择作为执行多重身份验证的默认第二因素的方法。 可取值为：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",
  "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"
}