Regeln für dynamische Mitgliedschaftsgruppen in Microsoft Entra ID verwalten

Sie können auf Benutzer- oder Geräteattributen basierende Regeln erstellen, um die Mitgliedschaft für dynamische Mitgliedschaftsgruppen in Microsoft Entra ID, Teil von Microsoft Entra, zu aktivieren. Sie können dynamische Mitgliedschaftsgruppen automatisch hinzufügen und entfernen, indem Sie Mitgliedschaftsregeln verwenden, die Mitgliederattributen basieren. In Microsoft Entra kann ein einzelner Mandant maximal 15.000 dynamische Mitgliedschaftsgruppen aufweisen.

In diesem Artikel werden die Eigenschaften und die Syntax zum Erstellen der Regeln für dynamische Mitgliedschaftsgruppen erläutert, die auf Benutzenden oder Geräten basieren.

Wenn sich die Attribute eines Benutzer oder Geräts ändern, bewertet das System alle Regeln für dynamische Mitgliedschaftsgruppen in einem Verzeichnis, um zu ermitteln, ob die Änderung irgendwelche Vorgänge zum Hinzufügen oder Löschen von Gruppen auslöst. Wenn ein Benutzer oder ein Gerät eine Regel für eine Gruppe erfüllt, wird dieser/dieses als Mitglied dieser Gruppe hinzugefügt. Wenn sie die Regel nicht mehr erfüllen, werden sie entfernt. Sie können ein Mitglied einer dynamischen Mitgliedschaftsgruppe nicht manuell hinzufügen oder entfernen.

• Sie können zwar eine dynamische Mitgliedschaftsgruppe für Benutzer oder Geräte erstellen, jedoch keine Regel festlegen, die sowohl Benutzer als auch Geräte enthält.
• Sie können keine Gerätemitgliedschaftsgruppe basierend auf den Benutzerattributen der Gerätebesitzenden erstellen. Die Regeln für die Gerätemitgliedschaft können sich nur auf Geräteattribute beziehen.

Regel-Generator im Azure-Portal

Microsoft Entra ID stellt einen Regel-Generator bereit, mit dem Sie wichtige Regeln schneller erstellen und aktualisieren können. Der Regel-Generator unterstützt die Erstellung von bis zu fünf Ausdrücken. Die Erstellung einer Regel mit einigen einfachen Ausdrücken wird durch den Regel-Generator vereinfacht, aber er kann nicht verwendet werden, um jede Regel zu reproduzieren. Falls der Regel-Generator die zu erstellende Regel nicht unterstützt, können Sie das Textfeld verwenden.

Hier finden Sie einige Beispiele für erweiterte Regeln oder Syntax, die die Verwendung des Textfelds erfordern:

• Regel mit mehr als fünf Ausdrücken
• Mitarbeiterregel
• Regeln mit -contains oder -notContains-Operator
• Festlegen der Rangfolge der Operatoren
• Regeln mit komplexen Ausdrücken; z.B., (user.proxyAddresses -any (_ -startsWith "contoso"))

Schrittweise Anweisungen dazu finden Sie unter Erstellen oder Aktualisieren einer dynamischen Mitgliedschaftsgruppe.

Regelsyntax für einen einzelnen Ausdruck

Ein einzelner Ausdruck ist die einfachste Form einer Mitgliedschaftsregel, und sie besteht nur aus den drei oben genannten Teilen. Eine Regel mit einem einzelnen Ausdruck sieht ähnlich wie in diesem Beispiel aus: Property Operator Value, wobei die Syntax für die Eigenschaft der Name der object.property ist.

Das folgende Beispiel zeigt eine richtig aufgebaute Mitgliedschaftsregel mit einem einzelnen Ausdruck:

user.department -eq "Sales"

Bei einem einzelnen Ausdruck sind Klammern optional. Die Gesamtlänge des Texts der Mitgliedschaftsregel darf 3072 Zeichen nicht überschreiten.

Erstellen des Texts einer Mitgliedschaftsregel

Eine Mitgliedschaftsregel, die eine Gruppe automatisch mit Benutzern oder Geräten auffüllt, ist ein binärer Ausdruck, der als Ergebnis true oder false ergibt. Die drei Teile einer einfachen Regel sind:

• Eigenschaft
• Operator
• Wert

Die Reihenfolge der Teile in einem Ausdruck ist wichtig, um Syntaxfehler zu vermeiden.

Unterstützte Eigenschaften

Es gibt drei Arten von Eigenschaften, die verwendet werden können, um eine Mitgliedschaftsregel zu erstellen.

• Boole'sche
• DateTime
• Zeichenkette
• Zeichenketten-Sammlung

Im Folgenden sind die Benutzereigenschaften aufgelistet, die Sie verwenden können, um einen einzelnen Ausdruck zu erstellen.

Eigenschaften vom Typ Boole'sche

Eigenschaften vom Typ DateTime

Eigenschaften vom Typ Zeichenkette

Eigenschaften vom Typ "string collection"

Die für Geräteregeln verwendeten Eigenschaften finden Sie unter Regeln für Geräte.

Unterstützte Ausdrucksoperatoren

Die folgende Tabelle enthält alle unterstützten Operatoren und deren Syntax für einen einzelnen Ausdruck. Alle Operatoren können mit oder ohne vorangestellten Bindestrich (-) verwendet werden. Der Operator Contains führt teilweise Zeichenketten-Übereinstimmungen durch, aber keine Übereinstimmungen von Elementen in einer Sammlung.

Mithilfe der Operatoren -in und -notIn

Wenn Sie den Wert eines Benutzerattributs mit einer Reihe mehrerer Werte vergleichen möchten, können Sie die Operatoren -in oder -notIn verwenden. Verwenden Sie die Klammersymbole "[" und "]" für den Anfang und das Ende der Liste von Werten.

Im folgenden Beispiel wird der Ausdruck als true ausgewertet, wenn der Wert von user.department einem der Werte in der Liste entspricht:

   user.department -in ["50001","50002","50003","50005","50006","50007","50008","50016","50020","50024","50038","50039","51100"]

Verwenden der Operatoren -le und -ge

Sie können die Operatoren für kleiner als (-le) oder größer als (-ge) verwenden, wenn Sie das employeeHireDate-Attribut in Regeln für dynamische Mitgliedschaftsgruppen verwenden.
Beispiele:

user.employeehiredate -ge system.now -plus p1d 

user.employeehiredate -le 2020-06-10T18:13:20Z 

Mithilfe des Operators -match

Der Operator -match wird für Übereinstimmungen mit beliebigen regulären Ausdrücken verwendet. Beispiele:

user.displayName -match "^Da.*"   

Da, Dav, David werden mit true ausgewertet, aDa hingegen mit false.

user.displayName -match ".*vid"

David wird mit true ausgewertet, Da hingegen mit false.

Unterstützte Werte

Die in einem Ausdruck verwendeten Werte können aus mehreren Typen bestehen, Beispiele:

• Zeichenfolgen
• Boole'sche - true, false
• Zahlen
• Arrays - Zahlenarray, Zeichenkettenarray

Wenn Sie einen Wert in einem Ausdruck angeben, ist es wichtig, die richtige Syntax zu verwenden, um Fehler zu vermeiden. Einige Tipps für die Syntax:

• Doppelte Anführungszeichen sind optional, es sei denn, der Wert ist eine Zeichenfolge.
• Bei RegEx und Vorgängen mit Zeichenketten wird die Groß- und Kleinschreibung nicht beachtet.
• Stellen Sie sicher, dass Eigenschaftennamen ordnungsgemäß wie dargestellt formatiert sind, da die Groß-/Kleinschreibung beachtet wird.
• Wenn ein Zeichenkettenwert doppelte Anführungszeichen enthält, sollten beide Anführungszeichen mit dem Zeichen ` maskiert werden, z. B. user.department -eq `„Sales`“ ist die richtige Syntax, wenn "Sales" der Wert ist. Einfache Anführungszeichen sollten jeweils mit zwei einfachen Anführungszeichen statt mit nur einem als Escapezeichen versehen werden.
• Sie können auch NULL-Überprüfungen durchführen, indem Sie NULL als Wert verwenden, Beispiel: user.department -eq null.

Verwenden von NULL-Werten

Zum Angeben eines NULL-Werts in einer Regel können Sie den Wert NULL verwenden.

• Verwenden Sie -eq oder -ne zum Vergleichen des NULL-Werts in einem Ausdruck.
• Setzen Sie das Wort NULL nur dann in Anführungszeichen, wenn es als wörtlicher Zeichenkettenwert interpretiert werden soll.
• Der -not-Operator kann nicht als Vergleichsoperator für NULL verwendet werden. Wenn Sie ihn verwenden, erhalten Sie eine Fehlermeldung, egal ob Sie NULL oder $NULL verwenden.

Die richtige Referenzierung des NULL-Werts erfolgt auf diese Weise:

   user.mail –ne null

Regeln mit mehreren Ausdrücken

Verwaltungsregeln für dynamische Mitgliedschaftsgruppen können aus mehreren Ausdrücken bestehen, die durch die logischen Operatoren -and, -or und -not verbunden sind. Logische Operatoren können auch in Kombination verwendet werden.

Im Folgenden sehen Sie Beispiele für ordnungsgemäß konstruierte Mitgliedschaftsregeln mit mehreren Ausdrücken:

(user.department -eq "Sales") -or (user.department -eq "Marketing")
(user.department -eq "Sales") -and -not (user.jobTitle -startsWith "SDE")

Rangfolge der Operatoren

Alle Operatoren sind unten in der Rangfolge von oben nach unten aufgeführt. Operatoren in der gleichen Zeile haben den gleichen Rang:

-eq -ne -startsWith -notStartsWith -contains -notContains -match –notMatch -in -notIn
-not
-and
-or
-any -all

Das folgende Beispiel zeigt die Rangfolge der Operatoren, bei dem zwei Ausdrücke für den Benutzer ausgewertet werden:

   user.department –eq "Marketing" –and user.country –eq "US"

Klammern sind nur erforderlich, wenn die Rangfolge nicht Ihren Anforderungen entspricht. Wenn die Abteilung zuerst ausgewertet werden soll, zeigt folgendes Beispiel, wie Klammern verwendet werden können, um die Reihenfolge zu bestimmen:

   user.country –eq "US" –and (user.department –eq "Marketing" –or user.department –eq "Sales")

Regeln mit komplexen Ausdrücken

Eine Mitgliedschaftsregel kann aus komplexen Ausdrücken bestehen, in denen die Eigenschaften, Operatoren und Werte komplexere Formen annehmen. Ausdrücke werden als komplex angesehen, wenn eine der folgenden Bedingungen zutrifft:

• Die Eigenschaft besteht aus einer Sammlung von Werten, insbesondere mehrwertigen Eigenschaften
• In den Ausdrücken werden die Operatoren -any und -all verwendet
• Der Wert des Ausdrucks kann selbst ein Ausdruck oder mehrere Ausdrücke sein

Mehrwertige Eigenschaften

Mehrwertige Eigenschaften sind Sammlungen von Objekten desselben Typs. Sie können verwendet werden, um mithilfe der logischen Operatoren -any und -all Mitgliedschaftsregel zu erstellen.

Verwenden der Operatoren -any und -all

Sie können die Operatoren -any und -all verwenden, um eine Bedingung auf ein Element oder alle Elemente in der Sammlung anzuwenden.

• -any (erfüllt, wenn mindestens ein Element in der Auflistung der Bedingung entspricht)
• -all (erfüllt, wenn alle Elemente in der Auflistung der Bedingung entsprechen)

Beispiel 1

assignedPlans ist eine mehrwertige Eigenschaft, die alle Service-Pläne auflistet, die dem Benutzer zugewiesen sind. Der folgende Ausdruck wählt Benutzer aus, die über einen Serviceplan von Exchange Online (Plan 2) verfügen (als GUID-Wert), der sich im Status Enabled befindet:

user.assignedPlans -any (assignedPlan.servicePlanId -eq "efb87545-963c-4e0d-99df-69c6916d9eb0" -and assignedPlan.capabilityStatus -eq "Enabled")

Mit einer Regel wie dieser können alle Benutzer gruppiert werden, für die eine Microsoft 365-Funktion (oder einen anderen Microsoft-Onlinedienst) aktiviert ist. Sie könnten dann einen Satz von Richtlinien auf die Gruppe anwenden.

Beispiel 2

Der folgende Ausdruck wählt alle Benutzer aus, die über einen Serviceplan verfügen, der mit dem Intune-Dienst (identifizierbar anhand des Dienstnamens "SCO") verknüpft ist:

user.assignedPlans -any (assignedPlan.service -eq "SCO" -and assignedPlan.capabilityStatus -eq "Enabled")

Beispiel 3

Mit dem folgenden Ausdruck werden alle Benutzer ausgewählt, die über keinen zugewiesenen Dienstplan verfügen:

user.assignedPlans -all (assignedPlan.servicePlanId -eq null)

Verwenden der Syntax mit Unterstrich (_)

Die Syntax mit Unterstrich (_) entspricht dem Vorkommen eines bestimmten Werts in einer mehrwertigen Eigenschaft der Zeichenketten-Sammlung, um Benutzer oder Geräte einer dynamischen Mitgliedschaftsgruppe hinzuzufügen. Die Syntax wird mit den Operatoren -any oder -all verwendet.

Im Folgenden sehen Sie ein Beispiel für die Verwendung des Unterstrichs (_) in einer Regel zum Hinzufügen von Mitgliedern basierend auf user.proxyAddress (identische Funktionsweise wie user.otherMails). Diese Regel fügt der Gruppe jeden Benutzer mit einer Proxyadresse hinzu, die mit „contoso“ beginnt.

(user.proxyAddresses -any (_ -startsWith "contoso"))

Andere Eigenschaften und allgemeine Regeln

Erstellen einer „Mitarbeiter“-Regel

Sie können eine Gruppe erstellen, die alle Mitarbeiter enthält, die einem Manager direkt unterstellt sind. Wenn sich die direkt unterstellten Mitarbeiter eines Managers in der Zukunft ändern, wird die Mitgliedschaft in der Gruppe automatisch angepasst.

Die Mitarbeiterregel wird mithilfe der folgenden Syntax erstellt:

Direct Reports for "{objectID_of_manager}"

Hier ist ein Beispiel für eine gültige Regel, wobei „aaaaaa-0000-1111-2222-bbbbbbbbbbbbbb“ die Objekt-ID des Managers ist:

Direct Reports for "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"

Die folgenden Tipps können helfen, die Regel ordnungsgemäß zu verwenden.

• Die Manager-ID ist die Objekt-ID des Managers. Sie finden sie im Profil des Managers.
• Damit diese Regel funktioniert, stellen Sie sicher, dass die Eigenschaft Manager für die Benutzer in Ihrer Organisation korrekt festgelegt ist. Sie können den aktuellen Wert im Profil des Benutzers überprüfen.
• Diese Regel unterstützt nur die dem Manager direkt unterstellten Mitarbeiter. Sie können also keine Gruppe mit dem Manager direkt unterstellten Mitarbeitern und den ihnen unterstellten Mitarbeitern erstellen.
• Diese Regel kann nicht mit anderen Mitgliedschaftsregeln kombiniert werden.

Erstellen einer Regel für „alle Benutzer“

Sie können mithilfe einer Mitgliedschaftsregel eine Gruppe mit allen Benutzern innerhalb einer Organisation erstellen. Wenn Benutzer in Zukunft zur Organisation hinzugefügt oder daraus entfernt werden, wird die Mitgliedschaft in der Gruppe automatisch angepasst.

Die Regel für „alle Benutzer“ wird mit einem einzelnen Ausdruck mit dem -ne-Operator und dem NULL-Wert erstellt. Mit dieser Regel werden B2B-Gastbenutzer und Mitgliedsbenutzer der Gruppe hinzugefügt.

user.objectId -ne null

Wenn Ihre Gruppe Gastbenutzer ausschließen und nur Mitglieder Ihrer Organisation enthalten soll, können Sie die folgende Syntax verwenden:

(user.objectId -ne null) -and (user.userType -eq "Member")

Erstellen einer Regel für „alle Geräte“

Sie können mithilfe einer Mitgliedschaftsregel eine Gruppe mit allen Geräten innerhalb einer Organisation erstellen. Wenn Geräte in Zukunft zur Organisation hinzugefügt oder daraus entfernt werden, wird die Mitgliedschaft in der Gruppe automatisch angepasst.

Die Regel für „alle Geräte“ wird mit einem einzelnen Ausdruck mit dem -ne-Operator und dem NULL-Wert erstellt:

device.objectId -ne null

Erweiterungseigenschaften und benutzerdefinierte Erweiterungseigenschaften

Erweiterungsattribute und benutzerdefinierte Erweiterungseigenschaften werden als Zeichenketten-Eigenschaften in den Regeln für dynamische Mitgliedschaftsgruppen unterstützt. Erweiterungsattribute können von einer lokalen Windows Server Active Directory-Instanz synchronisiert oder über Microsoft Graph aktualisiert werden und das Format „ExtensionAttributeX“ erhalten, wobei X den Zahlen 1 bis 15 entspricht. Erweiterungseigenschaften mit mehreren Werten werden in dynamischen Mitgliedschaftsgruppen nicht unterstützt.

Dies ist ein Beispiel für eine Regel, die ein Erweiterungsattribut als Eigenschaft verwendet:

(user.extensionAttribute15 -eq "Marketing")

Benutzerdefinierte Erweiterungseigenschaften können von einer lokalen Windows Server Active Directory-Instanz, von einer verbundenen SaaS-Anwendung synchronisiert oder über Microsoft Graph erstellt werden und weisen das Format user.extension_[GUID]_[Attribute] auf. Dabei gilt Folgendes:

• [GUID] ist die Kurzfassung des eindeutigen Bezeichners in Microsoft Entra ID für die Anwendung, die die Eigenschaft erstellt hat. Sie enthält nur die Zeichen 0–9 und A–Z
• [Attribute] ist der Name der Eigenschaft bei ihrer Erstellung

Beispiel für eine Regel, die eine benutzerdefinierte Erweiterungseigenschaft verwendet:

user.extension_c272a57b722d4eb29bfe327874ae79cb_OfficeNumber -eq "123"

Benutzerdefinierte Erweiterungseigenschaften werden auch als Verzeichnis- oder Microsoft Entra-Erweiterungseigenschaften bezeichnet.

Den Namen der benutzerdefinierten Eigenschaft finden Sie im Verzeichnis. Fragen Sie dazu die Eigenschaft eines Benutzers mithilfe des Graph-Explorers ab, und suchen Sie nach dem Eigenschaftennamen. Sie können jetzt im Regel-Generator für dynamische Mitgliedschaftsgruppen auf den Link Benutzerdefinierte Erweiterungseigenschaften abrufen klicken, um Ihre eindeutige App-ID einzugeben und die vollständige Liste mit benutzerdefinierten Erweiterungseigenschaften abzurufen, die Sie beim Erstellen einer dynamischen Mitgliedschaftsgruppe verwenden. Diese Liste kann auch aktualisiert werden, um neue benutzerdefinierte Erweiterungseigenschaften für diese App zu erhalten. Erweiterungsattribute und benutzerdefinierte Erweiterungseigenschaften müssen aus Anwendungen in Ihrem Mandanten stammen.

Weitere Informationen finden Sie unter Verwenden der Attribute in dynamischen Mitgliedschaftsgruppen im Artikel Microsoft Entra Connect-Synchronisierung: Verzeichniserweiterungen.

Regeln für Geräte

Sie können auch eine Regel erstellen, die Geräteobjekte für die Mitgliedschaft in einer Gruppe auswählt. Benutzer und Geräte können nicht gleichzeitig Gruppenmitglieder sein.

Bei Windows 10 lautet das richtige Format des Attributs deviceOSVersion wie folgt: (device.deviceOSVersion -startsWith "10.0.1"). Die Formatierung kann mit dem PowerShell-Cmdlet Get-MgDevice überprüft werden:

Get-MgDevice -Search "displayName:YourMachineNameHere" -ConsistencyLevel eventual | Select-Object -ExpandProperty 'OperatingSystemVersion'

Die folgenden Geräteattribute können verwendet werden.

Nächste Schritte

Diese Artikel enthalten zusätzliche Informationen zu Gruppen in Microsoft Entra ID.

• Anzeigen vorhandener Gruppen
• Erstellen einer neuen Gruppe und Hinzufügen von Mitgliedern
• Verwalten der Einstellungen einer Gruppe
• Verwalten der Mitgliedschaften einer Gruppe
• Regeln für dynamische Mitgliedschaftsgruppen für Benutzende verwalten