current_principal_is_member_of()

  • Artikel

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

Syntax

current_principal_is_member_of(Gruppe)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ 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 eine Drosselung durch 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 zu vermeiden, die Microsoft Entra ID.

Gibt zurück

Die Funktion gibt zurück true , wenn der aktuelle Prinzipal, der die Abfrage ausführt, erfolgreich mit mindestens einem Eingabeargument abgeglichen wurde. Andernfalls gibt die Funktion zurück false.

Beispiele

Abfrage ausführen

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:

Abfrage ausführen

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

Diese Funktion wird in Azure Monitor nicht unterstützt.