type de ressource de filtre

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Détermine les objets qui doivent être provisionnés dans l’application. Par exemple, vous souhaiterez peut-être approvisionner uniquement les utilisateurs situés aux États-Unis. Lorsqu’un filtre d’étendue est présent, les objets qui ne satisfont pas au filtre sont ignorés pendant la synchronisation.

Le filtre fait partie du mappage d’objets. Il se compose de plusieurs ensembles de groupes de filtres, et chaque groupe de filtres contient une ou plusieurs clauses. Un objet est considéré dans l’étendue du groupe (le groupe est évalué à true) uniquement si toutes les clauses du groupe sont évaluées à true.

Un objet est considéré dans l’étendue de l’ensemble de groupes (l’ensemble de groupes est évalué à true) si l’un des groupes de l’ensemble est évalué à true.

Pour plus d’informations, consultez Provisionnement d’applications basée sur des attributs avec des filtres d’étendue.

Propriétés

Propriété	Type	Description
categoryFilterGroups	collection filterGroup	*Experimental* Groupe de filtres défini pour déterminer si un objet donné appartient et doit être traité dans le cadre de ce mappage d’objets. Un objet est considéré dans l’étendue si l’un des groupes de la collection est évalué à true.
groupes	collection filterGroup	Groupe de filtres défini pour déterminer si un objet donné est dans l’étendue de l’approvisionnement. Il s’agit du filtre qui doit être utilisé dans la plupart des cas. Si un objet utilisé pour satisfaire ce filtre à un moment donné, puis que l’objet ou le filtre a été modifié afin que le filtre ne soit plus satisfait, cet objet *sera déprovisionné ». Un objet est considéré dans l’étendue si l’un des groupes de la collection est évalué à true.
inputFilterGroups	collection filterGroup	*Experimental* Groupe de filtres utilisé pour filtrer les objets au début de leur lecture à partir du répertoire. Si un objet ne satisfait pas à ce filtre, il n’est pas traité plus avant. Il est important de comprendre que si un objet utilisé pour satisfaire ce filtre à un moment donné, puis que l’objet ou le filtre a été modifié de sorte que le filtre n’est plus satisfait, ce type d’objet n’est PAS déprovisionné. Un objet est considéré dans l’étendue si l’un des groupes de la collection est évalué à true.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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