userRegistrationDetails 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示用户的身份验证方法的状态，包括注册了哪些方法以及用户已注册和能够使用的功能。 例如，多重身份验证、自助式密码重置和无密码身份验证。 有关此功能的许可证要求的详细信息，请参阅 身份验证方法活动：权限和许可证。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | userRegistrationDetails 集合 | 获取为 userRegistrationDetails 对象中定义的用户注册的身份验证方法列表。 |
| Get | 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",
"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"
}