current_principal_is_member_of()

  • Artigo

Verifica uma associação a um grupo ou a identidade da entidade de segurança atual que está executando a consulta.

Sintaxe

current_principal_is_member_of(Grupo)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
grupo dynamic ✔️ Uma matriz de literais de cadeia de caracteres na qual cada literal representa uma entidade de Microsoft Entra. Veja exemplos de entidades de segurança de Microsoft Entra.

Observação

Para evitar a limitação de Microsoft Entra ID, a current_principal_is_member_of() função só funciona com literais de cadeia de caracteres. Usar valores que não são literais de cadeia de caracteres resultará em um erro para evitar um número potencialmente grande de consultas para Microsoft Entra ID.

Retornos

A função retornará true se a entidade de segurança atual que executa a consulta for correspondida com êxito para pelo menos um argumento de entrada. Caso contrário, a função retornará false.

Exemplos

Executar a consulta

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

Saída

result
false

Como usar a matriz dinâmica em vez de vários argumentos:

Executar a consulta

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

Saída

result
false

Essa funcionalidade não é compatível com o Azure Monitor