filter リソースの種類

名前空間: microsoft.graph

重要

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

アプリケーションにプロビジョニングするオブジェクトを決定します。 たとえば、米国に位置するユーザーのみをプロビジョニングする場合があります。 スコープ フィルターが存在する場合、フィルターを満たさないオブジェクトは同期中にスキップされます。

フィルターは、オブジェクト マッピング の一部です。 複数のフィルター グループのセットで構成され、各フィルター グループには 1 つ以上の句が含まれています。 オブジェクトは、グループのすべての句が評価される場合にのみ、グループの範囲内にあると見なされます (グループは true 評価されます true )。

グループ セット内のグループが評価される場合、オブジェクトはグループ セットの範囲内にあると見なされます (グループ セットが true 評価されます true )。

詳細については、「スコープ フィルター を使用した属性ベースのアプリケーション プロビジョニング」を参照してください。

プロパティ

プロパティ	型	説明
categoryFilterGroups	filterGroup コレクション	*Experimental* 特定のオブジェクトが属するかどうかを決定するために使用されるフィルター グループ セット。このオブジェクト マッピングの一部として処理する必要があります。 コレクション内のグループの 1 つが評価される場合、オブジェクトは範囲内 にあると見なされます true。
groups	filterGroup コレクション	指定されたオブジェクトがプロビジョニングの対象であるかどうかを判断するために使用されるフィルター グループ セット。 これは、ほとんどの場合に使用する必要があるフィルターです。 このフィルターを満たすために使用されるオブジェクトが特定の時点で、そのオブジェクトまたはフィルターが変更され、フィルターが満たされなくなった場合、そのようなオブジェクト *はプロビジョニングが取り戻されます。 コレクション内のグループの 1 つが評価される場合、オブジェクトは範囲内 にあると見なされます true。
inputFilterGroups	filterGroup コレクション	*Experimental* ディレクトリからオブジェクトを読み取る初期段階でオブジェクトをフィルター処理するために使用されるフィルター グループ セット。 オブジェクトがこのフィルターを満たしていない場合、それ以上処理されません。 理解する重要な点は、特定の時点でこのフィルターを満たすために使用されたオブジェクトが、フィルターが満たされなくなったオブジェクトまたはフィルターが変更された場合、そのようなオブジェクトはプロビジョニングされなくなるという点 です。 コレクション内のグループの 1 つが評価される場合、オブジェクトは範囲内 にあると見なされます true。

JSON 表記

以下は、リソースの JSON 表記です。

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