homeRealmDiscoveryPolicy 资源类型

命名空间:microsoft.graph

表示一种策略,用于控制联合用户的Microsoft Entra身份验证行为,尤其是针对联合域中的自动加速和用户身份验证限制。 可以为组织中的所有服务主体或组织中的特定服务主体设置 homeRealmDiscoveryPolicy 。 有关更多方案和策略详细信息,请参阅使用主领域发现策略配置应用程序的Microsoft Entra登录行为和使用电子邮件作为备用登录 ID 登录到Microsoft Entra ID

继承自 stsPolicy

方法

方法 返回类型 说明
列出 homeRealmDiscoveryPolicy homeRealmDiscoveryPolicy 读取 homeRealmDiscoveryPolicies 对象的属性和关系。
创建 homeRealmDiscoveryPolicy homeRealmDiscoveryPolicy 创建 homeRealmDiscoveryPolicy 对象。
获取主页RealmDiscoveryPolicy homeRealmDiscoveryPolicy 读取 homeRealmDiscoveryPolicy 对象的属性和关系。
更新主页RealmDiscoveryPolicy None 更新 homeRealmDiscoveryPolicy 对象。
删除 homeRealmDiscoveryPolicy None 删除 homeRealmDiscoveryPolicy 对象。
List appliesTo directoryObject collection 获取已应用此策略的 directoryObject 列表。

属性

属性 类型 说明
定义 字符串集合 一个字符串集合,其中包含定义此策略的规则和设置的 JSON 字符串。 有关此属性的 JSON 架构的更多详细信息,请参阅 主领域发现策略定义的 属性。 必需。
description String 此策略的说明。
displayName String 此策略的显示名称。 必需。
id String 此策略的唯一标识符。 只读。
isOrganizationDefault 布尔值 如果设置为 true,则激活此策略。 同一策略类型可以有多个策略,但只有一种策略可以激活为组织默认策略。 可选,默认值为 false

主领域发现策略定义的属性

下面的属性构成表示令牌生存期策略的 JSON 对象。 此 JSON 对象必须 转换为带转义引号的字符串 ,才能插入 到定义 属性中。 下面以 JSON 格式显示一个示例:

"definition": [
    "{
        \"HomeRealmDiscoveryPolicy\": {
          \"AccelerateToFederatedDomain\":true,
          \"AllowCloudPasswordValidation\": false,
          \"PreferredDomain\":\"federated.example.edu\",
          \"AlternateIdLogin\":{
            \"Enabled\":true
          }
        }
      }"
  ]
属性 类型 说明
AccelerateToFederatedDomain 布尔值 true对于自动加速 (绕过主领域发现) ,请将 设置为 。 如果 true 租户中只有一个经过验证的联合域,则用户将直接转到联合标识提供者 ((例如 ADFS) )进行登录。 如果 true 租户中有多个已验证域,则必须指定 PreferredDomain 。 可选。
AllowCloudPasswordValidation 布尔值 设置为 以true允许应用程序通过直接向Microsoft Entra令牌终结点提供用户名/密码凭据来对联合用户进行身份验证。 仅当启用了密码哈希同步时有效。 可选。
AlternateIdLogin Json 设置为 以{\"Enabled\": true}允许Microsoft Entra使用电子邮件作为备用登录 ID 登录。 仅当 IsOrganizationDefault 设置为 true时有效。 可选。
PreferredDomain String 指定要加速登录的域。 如果租户只有一个联合域,则可以省略它。 如果省略它,并且有多个已验证的联合域,则此策略无效。 如果 AccelerateToFederatedDomain 为 ,则 true为 必需。

关系

关系 类型 说明
appliesTo directoryObject collection 已应用此策略的 directoryObject 集合。 只读。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "definition": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isOrganizationDefault": true
}