Freigeben über

current_principal_is_member_of()

  • Artikel

Gilt für: ✅Microsoft Fabric✅✅

Überprüft die Gruppenmitgliedschaft oder Prinzipalidentität des aktuellen Prinzipals, der die Abfrage ausführt.

Syntax

current_principal_is_member_of( group)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
group dynamic ✔️ Ein Array von Zeichenfolgenliteralen, in denen jedes Literal einen Microsoft Entra-Prinzipal darstellt. Beispiele für Microsoft Entra-Prinzipale.

Hinweis

  • Um die Drosselung von Microsoft Entra-ID zu vermeiden, funktioniert die current_principal_is_member_of() Funktion nur mit Zeichenfolgenliteralen. Die Verwendung von Werten, die keine Zeichenfolgenliterale sind, führt zu einem Fehler, um eine potenziell große Anzahl von Abfragen an Microsoft Entra ID zu vermeiden.
  • Die Überprüfung von Gruppenmitgliedschaften kann ressourcenintensiv sein. Da sich Gruppenmitgliedschaften nicht häufig ändern, werden die Ergebnisse der Mitgliedschaftsprüfung zwischengespeichert. Die Zwischenspeicherungsdauer variiert und bestimmt, wie schnell Änderungen an Gruppenmitgliedschaften aktualisiert werden. Das Hinzufügen eines Benutzers zu einer Gruppe kann bis zu 30 Minuten dauern, bis er verteilt wird. Das Entfernen eines Benutzers aus einer Gruppe kann bis zu drei Stunden dauern.
  • Weitere Informationen zum Cacheverhalten der Gruppenmitgliedschaft finden Sie unter Übersicht über die Zugriffssteuerung.

Gibt zurück

Die Funktion gibt zurück true , wenn der aktuelle Prinzipal, der die Abfrage ausführt, für mindestens ein Eingabeargument erfolgreich abgeglichen wird. Ist dies nicht der Fehler, wird die Funktion zurückgegeben false.

Beispiele

print result=current_principal_is_member_of(
    'aaduser=user1@fabrikam.com', 
    'aadgroup=group1@fabrikam.com',
    'aadapp=66ad1332-3a94-4a69-9fa2-17732f093664;72f988bf-86f1-41af-91ab-2d7cd011db47'
    )

Ausgabe

result
false

Verwenden eines dynamischen Arrays anstelle mehrerer Argumente:

print result=current_principal_is_member_of(
    dynamic([
    'aaduser=user1@fabrikam.com', 
    'aadgroup=group1@fabrikam.com',
    'aadapp=66ad1332-3a94-4a69-9fa2-17732f093664;72f988bf-86f1-41af-91ab-2d7cd011db47'
    ]))

Ausgabe

result
false