Condividi tramite

current_principal_is_member_of()

  • Articolo

Si applica a: ✅Microsoft Fabric✅

Controlla l'appartenenza al gruppo o l'identità principale dell'entità corrente che esegue la query.

Sintassi

current_principal_is_member_of( group)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
group dynamic ✔️ Matrice di valori letterali stringa in cui ogni valore letterale rappresenta un'entità Microsoft Entra. Vedere esempi per le entità di sicurezza di Microsoft Entra.

Nota

  • Per evitare la limitazione da Microsoft Entra ID, la current_principal_is_member_of() funzione funziona solo con valori letterali stringa. L'uso di valori che non sono valori letterali stringa genererà un errore per evitare un numero potenzialmente elevato di query nell'ID Microsoft Entra.
  • Il controllo delle appartenenze ai gruppi può richiedere un uso intensivo delle risorse. Poiché le appartenenze ai gruppi non cambiano di frequente, i risultati del controllo dell'appartenenza vengono memorizzati nella cache. La durata della memorizzazione nella cache varia e determina la velocità di aggiornamento delle modifiche alle appartenenze ai gruppi. L'aggiunta di un utente a un gruppo può richiedere fino a 30 minuti per propagarsi. La rimozione di un utente da un gruppo può richiedere fino a tre ore.
  • Per altre informazioni sul comportamento della cache delle appartenenze ai gruppi, vedere Panoramica del controllo di accesso.

Valori restituiti

La funzione restituisce true se l'entità corrente che esegue la query viene trovata correttamente per almeno un argomento di input. In caso contrario, la funzione restituisce false.

Esempi

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'
    )

Output

result
false

Uso della matrice dinamica anziché di più argomenti:

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'
    ]))

Output

result
false