筛选器资源类型

命名空间：microsoft.graph

重要

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

确定应将哪些对象预配到应用程序。 例如，你可能只想预配位于美国的用户。 存在范围筛选器时，同步期间将跳过不满足筛选器的对象。

筛选器是 对象映射的一部分。 它由多个筛选器组集组成，每个筛选器组包含一个或多个子句。 仅当组的所有子句都计算为 时，才会将对象视为在组范围内， (该组的计算truetrue结果为) 。

将对象视为在组集的范围内， (组集的计算 true 结果为) 如果集合中的任何组的 true计算结果为 。

有关详细信息，请参阅 使用范围筛选器进行基于属性的应用程序预配

属性

属性	类型	说明
categoryFilterGroups	filterGroup 集合	*Experimental* 用于确定给定对象是否属于且应作为此对象映射的一部分进行处理的筛选器组集。 如果将集合中的任何组的计算结果计算为 true，则会将对象视为范围内的对象。
groups	filterGroup 集合	筛选器组集用于确定给定对象是否在预配范围内。 这是在大多数情况下应使用的筛选器。 如果用于在给定时刻满足此筛选器的对象，然后对象或筛选器已更改，以便不再满足该筛选器，则此对象 *将取消预配”。 如果将集合中的任何组的计算结果计算为 true，则会将对象视为范围内的对象。
inputFilterGroups	filterGroup 集合	*Experimental* 筛选器组集用于在从目录中读取对象的早期阶段筛选出对象。 如果对象不满足此筛选器，则不会对其进行进一步处理。 请务必了解，如果用于在给定时刻满足此筛选器的对象，然后更改了对象或筛选器，以便不再满足筛选器，则不会 取消预配此类对象。 如果将集合中的任何组的计算结果计算为 true，则会将对象视为范围内的对象。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "categoryFilterGroups": [
    {
      "@odata.type": "microsoft.graph.filterGroup"
    }
  ],
  "groups": [
    {
      "@odata.type": "microsoft.graph.filterGroup"
    }
  ],
  "inputFilterGroups": [
    {
      "@odata.type": "microsoft.graph.filterGroup"
    }
  ]
}