Filterressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Bestimmt, welche Objekte für die Anwendung bereitgestellt werden sollen. Sie können beispielsweise nur Benutzer bereitstellen, die sich in den USA befinden. Wenn ein Filter vorhanden ist, werden Objekte, die den Filter nicht erfüllen, während der Synchronisierung übersprungen.

Filter ist Teil der Objektzuordnung. Sie besteht aus mehreren Gruppen von Filtergruppen, und jede Filtergruppe enthält eine oder mehrere Klauseln. Ein Objekt wird nur dann als Bereich für die Gruppe betrachtet (die Gruppe wird ausgewertet als ), wenn alle Klauseln der true Gruppe ausgewertet werden. true

Ein Objekt wird als Bereich für den Gruppensatz betrachtet (gruppensatz wird ausgewertet auf ), wenn eine der Gruppen in der Gruppe true ausgewertet wird auf true .

Weitere Informationen finden Sie unter "Attributbasierte Anwendungsbereitstellung mit Suchfiltern".

Eigenschaften

Eigenschaft	Typ	Beschreibung
categoryFilterGroups	filterGroup-Auflistung	*Experimental* Filtergruppensatz, der verwendet wird, um zu entscheiden, ob ein bestimmtes Objekt gehört und im Rahmen dieser Objektzuordnung verarbeitet werden soll. Ein Objekt wird im Bereich berücksichtigt, wenn ANY true der Gruppen in der Auflistung ausgewertet wird.
groups	filterGroup-Auflistung	Filtergruppensatz, der verwendet wird, um zu entscheiden, ob sich ein bestimmtes Objekt im Bereitstellungsbereich befindet. Dies ist der Filter, der in den meisten Fällen verwendet werden sollte. Wenn ein Objekt, das verwendet wurde, um diesen Filter zu einem bestimmten Zeitpunkt zu erfüllen, und dann das Objekt oder der Filter geändert wurde, sodass der Filter nicht mehr erfüllt wird, wird dieses Objekt *nicht mehr bereitgestellt." Ein Objekt wird im Bereich berücksichtigt, wenn ANY der Gruppen in der Auflistung ausgewertet wird. true
inputFilterGroups	filterGroup-Auflistung	*Experimental* Filtergruppensatz, mit dem Objekte frühzeitig aus dem Verzeichnis herausgefiltert werden. Wenn ein Objekt diesen Filter nicht erfüllt, wird es nicht weiter verarbeitet. Wichtig zu verstehen ist: Wenn ein Objekt, das verwendet wurde, um diesen Filter zu einem bestimmten Zeitpunkt zu erfüllen, und dann das Objekt oder der Filter geändert wurde, sodass der Filter nicht mehr erfüllt wird, wird die Bereitstellung dieses Objekts nicht mehr aufbeentigt. Ein Objekt wird im Bereich berücksichtigt, wenn ANY true der Gruppen in der Auflistung ausgewertet wird.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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