Gerenciar regras de grupos de associação dinâmica no Microsoft Entra ID

Você pode criar regras baseadas em atributos de usuário ou dispositivo para habilitar a associação para um grupo de associação dinâmica no Microsoft Entra ID, parte do Microsoft Entra. Você pode adicionar e remover os grupos de associação dinâmica automaticamente usando regras de associação com base em atributos de membro. No Microsoft Entra, um único locatário pode ter no máximo 15.000 grupos de associação dinâmica.

Este artigo detalha as propriedades e a sintaxe para criar regras de grupos de associação dinâmica com base em usuários ou dispositivos.

Quando os atributos de um usuário ou um dispositivo são alterados, o sistema avalia todas as regras de grupos de associação dinâmica em um diretório para ver se a alteração dispararia adições ou remoções de grupo. Se um usuário ou dispositivo atender a uma regra em um grupo, ele será adicionado como membro desse grupo. Se não atender mais à regra, ele será removido. Manualmente, não é possível adicionar nem remover um grupo de associação dinâmica.

• Você pode criar grupos de associação dinâmica para dispositivos ou usuários, mas não pode criar uma regra que contenha usuários e dispositivos.
• Você não pode criar um grupo de associação de dispositivos com base nos atributos de usuário do proprietário do dispositivo. Regras de associação de dispositivo podem fazer referência somente a atributos do dispositivo.

Construtor de regras no portal do Azure

O Microsoft Entra ID fornece um construtor de regras para criar e atualizar suas regras importantes mais rapidamente. O construtor de regras dá suporte à construção de até cinco expressões. O construtor de regras torna mais fácil formar uma regra com algumas expressões simples, no entanto, ela não pode ser usada para reproduzir todas as regras. Se o construtor de regras não oferecer suporte à regra que você deseja criar, você poderá usar a caixa de texto.

Aqui estão alguns exemplos de regras ou sintaxe avançadas que exigem o uso da caixa de texto:

• Regra com mais de cinco expressões
• A regra de Subordinados diretos
• Regras com o operador -contains ou -notContains
• Como definir a precedência do operador
• Regras com expressões complexas; por exemplo (user.proxyAddresses -any (_ -startsWith "contoso"))

Para obter instruções passo a passo, confira Criar ou atualizar um grupo de associação dinâmica.

Sintaxe de regra para uma única expressão

Uma única expressão é a forma mais simples de uma regra de associação e só tem as três partes mencionadas acima. Uma regra com uma única expressão é semelhante a este exemplo: Property Operator Value, em que a sintaxe para a propriedade é o nome do object.property.

O exemplo a seguir ilustra uma regra de associação construída de maneira adequada com uma única expressão:

user.department -eq "Sales"

Parênteses são opcionais para uma única expressão. O comprimento total do corpo de sua regra de associação não pode ultrapassar 3072 caracteres.

Construção do corpo de uma regra de associação

Uma regra de associação que preenche automaticamente um grupo de usuários ou dispositivos é uma expressão binária que resulta em um resultado verdadeiro ou falso. As três partes de uma regra simples são:

• Propriedade
• Operador
• Valor

A ordem das partes de uma expressão é importante para evitar erros de sintaxe.

Propriedades com suporte

Há três tipos de propriedades que podem ser usadas para construir uma regra de associação.

• Booliano
• DateTime
• String
• Coleção de Cadeias de Caracteres

Estas são todas as propriedades do usuário que você pode usar para criar uma expressão única.

Propriedades de tipo booliano

Propriedades do tipo dateTime

Propriedades do tipo cadeia de caracteres

Propriedades de coleção de cadeias de caracteres de tipo

Para as propriedades usadas para regras de dispositivo, consulte Regras para dispositivos.

Operadores de expressão com suporte

A tabela a seguir lista os operadores com suporte e sua sintaxe para uma única expressão. Os operadores podem ser usados com ou sem o prefixo de hífen (-). O operador Contains faz correspondências parciais de cadeia de caracteres, mas não faz correspondências do tipo item em uma coleção.

Usando os operadores -in e -notIn

Se quiser comparar o valor de um atributo de usuário com diversos valores, você poderá usar os operadores -in ou -notIn. Usar os símbolos entre colchetes "[" e "]" para iniciar e finalizar a lista de valores.

No exemplo a seguir, a expressão avalia como verdadeira se o valor de user.department for igual a um dos valores na lista:

   user.department -in ["50001","50002","50003","50005","50006","50007","50008","50016","50020","50024","50038","50039","51100"]

Usar os operadores -le e -ge

Você pode usar operadores menores que (-le) ou maiores que (-ge) ao usar o atributo employeeHireDate em regras de grupos de associação dinâmica.
Exemplos:

user.employeehiredate -ge system.now -plus p1d 

user.employeehiredate -le 2020-06-10T18:13:20Z 

Usando o operador -match

O operador -match é usado para corresponder qualquer expressão regular. Exemplos:

user.displayName -match "^Da.*"   

Da, Dav, David são avaliados como true, aDa é avaliado como false.

user.displayName -match ".*vid"

David é avaliado como true, Da é avaliado como false.

Valores com suporte

Os valores usados em uma expressão podem consistir em vários tipos, incluindo:

• Cadeias de caracteres
• Booliano – verdadeiro, falso
• Números
• Matrizes – matriz de número, matriz de cadeia de caracteres

Ao especificar um valor dentro de uma expressão é importante usar a sintaxe correta para evitar erros. Algumas dicas de sintaxe são:

• Aspas duplas são opcionais, a menos que o valor seja uma cadeia de caracteres.
• As operações Regex e cadeia de caracteres não diferenciam maiúsculas de minúsculas.
• Verifique se os nomes de propriedade estão formatados corretamente conforme mostrado, pois diferenciam maiúsculas de minúsculas.
• Quando um valor de cadeia de caracteres contiver aspas duplas, ambas as aspas devem ser ignoradas usando o caracter `, por exemplo, "Vendas" é a sintaxe adequada quando o valor "Vendas". É preciso fazer o escape de aspas simples usando duas aspas simples em vez de uma a cada vez.
• Você também pode executar os valores de Null, usando null como valor, por exemplo, user.department -eq null.

Uso de valores nulos

Para especificar um valor nulo em uma regra, você pode usar o valor null.

• Use -eq ou -ne quando comparado o valor de null em uma expressão.
• Usa cotações em torno da palavra null apenas se você quiser que seja interpretado como valor de cadeia de caracteres literal.
• O operador -not não pode ser usado como um operador comparativo para nulo. Se for utilizado, você receberá um erro se usar nulo ou $null.

A maneira correta para referenciar o valor nulo é da seguinte maneira:

   user.mail –ne null

Regras com várias expressões

Gerenciar regras de grupos de associação dinâmica pode consistir em mais de uma única expressão conectada pelos operadores lógicos -and, -or e -not. Operadores lógicos também podem ser usados em combinação.

A seguir estão exemplos de regras de associação construídas de maneira adequada com várias expressões:

(user.department -eq "Sales") -or (user.department -eq "Marketing")
(user.department -eq "Sales") -and -not (user.jobTitle -startsWith "SDE")

Precedência do operador

Todos os operadores estão listados abaixo na ordem de precedência da mais alta para a mais baixa. Os operadores na mesma linha têm a mesma precedência:

-eq -ne -startsWith -notStartsWith -contains -notContains -match –notMatch -in -notIn
-not
-and
-or
-any -all

O exemplo a seguir ilustra a precedência de operador em que as duas expressões são sendo avaliadas para o usuário:

   user.department –eq "Marketing" –and user.country –eq "US"

Parênteses são necessários somente quando a precedência não atender às suas necessidades. Por exemplo, se desejar que o departamento a seja avaliada pela primeira vez, a seguir mostra como os parênteses podem ser usados para determinar a ordem:

   user.country –eq "US" –and (user.department –eq "Marketing" –or user.department –eq "Sales")

Regras com expressões complexas

Uma regra de associação pode consistir em expressões complexas, onde as propriedades, operadores e valores assumem formas mais complexas. Expressões são consideradas complexas quando qualquer uma das seguintes opções for verdadeira:

• A propriedade consiste em uma coleção de valores; Especificamente, as propriedades com vários valores
• As expressões usam -qualquer e - todos os operadores
• O valor da expressão pode ser uma ou mais expressão

Propriedades de vários valores

As propriedades de vários valores são coleções de objetos do mesmo tipo. Eles podem ser usados para criar regras de associação usando a opção - any e - todos os operadores lógicos.

Usando os operadores -qualquer e -todos

Você pode usar os operadores -any e -all para aplicar uma condição a um ou todos os itens na coleção, respectivamente.

• -any (satisfeita quando pelo menos um item na coleção corresponde à condição)
• -all (satisfeita quando todos os itens na coleção correspondem à condição)

Exemplo 1

assignedPlans é uma propriedade de valores múltiplos que lista todos os planos de serviço atribuídos ao usuário. A expressão abaixo selecionará os usuários que tenham o plano do serviço Exchange Online (Plano 2) (como o valor GUID) e que também estejam no estado Habilitado:

user.assignedPlans -any (assignedPlan.servicePlanId -eq "efb87545-963c-4e0d-99df-69c6916d9eb0" -and assignedPlan.capabilityStatus -eq "Enabled")

Uma regra como esta pode ser usada para agrupar todos os usuários para os quais uma funcionalidade do Microsoft 365 ou de outro Serviço Online da Microsoft está habilitada. Você poderia aplicar com um conjunto de políticas ao grupo.

Exemplo 2

A expressão a seguir seleciona todos os usuários que possuem algum plano de serviço associado ao serviço do Intune (identificado pelo nome de serviço "SCO"):

user.assignedPlans -any (assignedPlan.service -eq "SCO" -and assignedPlan.capabilityStatus -eq "Enabled")

Exemplo 3

A seguinte expressão seleciona todos os usuários que não têm nenhum plano de serviço atribuído:

user.assignedPlans -all (assignedPlan.servicePlanId -eq null)

Usar a sintaxe de sublinhado (_)

A sintaxe de sublinhado (_) corresponde a ocorrências de um valor específico em uma das propriedades de coleção de cadeia caracteres de valores variados para adicionar usuários ou dispositivos a um grupo de associação dinâmica. Ele é usado com os operadores -any ou -all.

Aqui está um exemplo do uso do sublinhado (_) em uma regra para adicionar membros com base em user.proxyAddress (funciona da mesma forma para user.otherMails). Essa regra adiciona ao grupo qualquer usuário com endereço proxy que comece com "contoso".

(user.proxyAddresses -any (_ -startsWith "contoso"))

Outras propriedades e as regras comuns

Criar regra de "relatórios diretos”

Você pode criar um grupo contendo todos os subordinados diretos de um gerente. Quando os subordinados diretos do gerente forem alterados no futuro, a associação do grupo será ajustada automaticamente.

Os relatórios diretos são construídos usando a sintaxe a seguir:

Direct Reports for "{objectID_of_manager}"

Aqui está um exemplo de uma regra válida, em que “aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb” é a objectID do gerente:

Direct Reports for "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"

As dicas a seguir podem ajudá-lo a usar a regra corretamente.

• O Manager ID é a ID de objeto do Gerenciador. Ele pode ser encontrado no Gerenciador de Perfil.
• Para que a regra funcione, verifique se a propriedade ID do Gerenciador está definida corretamente nos usuários em sua organização. Você pode verificar o valor atual no Perfil do usuário.
• Essa regra dá suporte a apenas os relatórios de diretos do gerente. Em outras palavras, é possível criar um grupo com subordinados diretos do gerente e seus relatórios.
• Esta regra não pode ser combinada com nenhuma outra regra avançada.

Criar uma regra de "Todos os usuários"

Você pode criar um grupo contendo todos os usuários dentro de uma organização usando uma regra de associação. Quando os usuários são adicionados ou removidos da organização no futuro, a associação do grupo é ajustada automaticamente.

A regra "Todos os usuários" é construída usando a única expressão usando o operador -ne e o valor nulo. Essa regra adiciona usuários convidados de B2B e usuários de membro ao grupo.

user.objectId -ne null

Se você quiser que o grupo exclua os usuários convidados e inclua somente os membros da sua organização, poderá usar a seguinte sintaxe:

(user.objectId -ne null) -and (user.userType -eq "Member")

Criar uma regra "Todos os dispositivos"

Você pode criar um grupo contendo todos os dispositivos dentro de uma organização usando uma regra de associação. Quando os dispositivos são adicionados ou removidos da organização no futuro, a associação do grupo é ajustada automaticamente.

A regra "Todos os Dispositivos" é construída usando a única expressão usando o operador -ne e o valor nulo:

device.objectId -ne null

Propriedades de extensão e propriedades de extensão personalizadas

Os atributos de extensão e as propriedades de extensão personalizadas são aceitos como propriedades de cadeia de caracteres nas regras de grupos de associação dinâmica. Os atributos de extensão podem ser sincronizados do Active Directory do Windows Server local ou atualizados usando o Microsoft Graph e têm o formato "ExtensionAttributeX", em que X é igual a 1 a 15. As propriedades de extensão de vários valores não são aceitas em regras de grupos de associação dinâmica.

Um exemplo de uma regra que usa um atributo de extensão como propriedade:

(user.extensionAttribute15 -eq "Marketing")

As propriedades de extensão personalizadas podem ser sincronizadas do Windows Server Active Directory local, de um aplicativo SaaS conectado ou criados usando o Microsoft Graph e estão no formato de user.extension_[GUID]_[Attribute], em que:

• [GUID] é uma versão separada do identificador exclusivo no Microsoft Entra ID para o aplicativo que criou a propriedade. Ele contém apenas caracteres de 0 a 9 e de A a Z
• [Atributo] é o nome da propriedade como ele foi criado

Um exemplo de uma regra que usa um atributo personalizado:

user.extension_c272a57b722d4eb29bfe327874ae79cb_OfficeNumber -eq "123"

Propriedades de extensão personalizadas também são chamadas de propriedades de extensão de diretório ou do Microsoft Entra.

O nome da propriedade personalizada pode ser encontrado no diretório por meio da consulta do atributo de um usuário, usando o Explorador de gráficos e procurando o nome do atributo. Além disso, agora você pode selecionar o link Obter propriedades de extensão personalizadas no construtor de regras de grupos de associação dinâmica para inserir uma ID do aplicativo exclusiva e receber a lista completa de propriedades de extensão personalizadas para usar ao criar uma regra de grupos de associação dinâmica. Essa lista também pode ser atualizada para obter as novas propriedades de extensão personalizadas do aplicativo. Atributos de extensão e propriedades de extensão personalizadas precisam ser de aplicativos em seu locatário.

Para mais informações, confira Usar os atributos em grupos de associação dinâmicoa no artigo Microsoft Entra Connect Sync: Extensões de diretório.

Regras para dispositivos

Você também pode criar uma regra que seleciona objetos de dispositivo para associação em um grupo. Você não pode ter usuários e dispositivos como membros do grupo.

Para o Windows 10, o formato correto do atributo deviceOSVersion é o seguinte: (device.deviceOSVersion -startsWith "10.0.1"). A formatação pode ser validada com o cmdlet Get-MgDevice do PowerShell:

Get-MgDevice -Search "displayName:YourMachineNameHere" -ConsistencyLevel eventual | Select-Object -ExpandProperty 'OperatingSystemVersion'

Os seguintes atributos de dispositivo podem ser usados.

Próximas etapas

Esses artigos fornecem mais informações sobre grupos no Microsoft Entra ID.

• Consultar grupos existentes
• Criar um novo grupo e adicionando membros
• Gerenciar configurações de um grupo
• Gerenciar associações de um grupo
• Gerenciar regras de grupos de associação dinâmica para usuários