Bagikan melalui

current_principal_is_member_of()

  • Artikel

Berlaku untuk: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Memeriksa keanggotaan grup atau identitas prinsipal dari prinsipal saat ini yang menjalankan kueri.

Sintaks

current_principal_is_member_of(grup)

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama Tipe Wajib Deskripsi
grup dynamic ✔️ Array literal string di mana setiap literal mewakili perwakilan Microsoft Entra. Lihat contoh untuk perwakilan Microsoft Entra.

Catatan

  • Untuk menghindari pembatasan dari ID Microsoft Entra, current_principal_is_member_of() fungsi hanya berfungsi dengan literal string. Menggunakan nilai yang bukan string literal akan mengakibatkan kesalahan untuk menghindari sejumlah besar kueri ke ID Microsoft Entra.
  • Memeriksa keanggotaan grup dapat menjadi intensif sumber daya. Karena keanggotaan grup tidak sering berubah, hasil pemeriksaan keanggotaan di-cache. Durasi penembolokan bervariasi dan dipengaruhi oleh faktor-faktor seperti hasil keanggotaan (apakah prinsipal adalah anggota atau tidak), jenis prinsipal (pengguna atau aplikasi), antara lain. Durasi penembolokan maksimum dapat diperpanjang hingga tiga jam, sedangkan durasi minimum adalah 30 menit.

Mengembalikan

Fungsi mengembalikan true jika prinsipal saat ini yang menjalankan kueri berhasil dicocokkan untuk setidaknya satu argumen input. Jika tidak, fungsi mengembalikan false.

Contoh

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

Hasil

hasil
salah

Menggunakan array dinamis, alih-alih beberapa argumen:

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

Hasil

hasil
salah