Compartilhar via

Alterar grupos estáticos para grupos de associação dinâmica no Microsoft Entra ID

Você pode alterar a associação de um grupo de estático para dinâmico (ou vice-versa) no Microsoft Entra ID. O Microsoft Entra ID mantém o mesmo nome do grupo e ID no sistema, para que todas as referências existentes ao grupo ainda são válidas. Se você criar um novo grupo em vez disso, precisará atualizar essas referências.

A criação de grupos de associação dinâmica elimina a sobrecarga de gerenciamento de adicionar e remover usuários. Este artigo mostra como converter grupos de associação existentes de estáticos para dinâmicos usando o portal do Azure ou os cmdlets do PowerShell. No Microsoft Entra, um único locatário pode ter no máximo 15.000 grupos de associação dinâmica.

Aviso

Quando você altera um grupo estático existente para um grupo dinâmico, todos os membros existentes são removidos do grupo. Em seguida, a regra de associação é processada para adicionar novos membros. Se o grupo for usado para controlar o acesso a aplicativos ou recursos, os membros originais poderão perder o acesso até que a regra de associação seja totalmente processada.

É recomendável testar a nova regra de associação antes para garantir que a nova associação no grupo esteja conforme esperado. Se você encontrar erros durante o teste, consulte Resolver problemas de licença de grupo.

Pré-requisitos

  • Para alterar o tipo de associação usando o portal, você precisa de uma conta que tenha pelo menos a função administrador de grupos .

  • Para alterar as propriedades de grupo dinâmico usando o PowerShell, você precisa usar cmdlets do módulo do Microsoft Graph PowerShell. Para obter mais informações, consulte Instalar o SDK do Microsoft Graph PowerShell.

Alterar o tipo de associação de um grupo (portal)

  1. Entre no Centro de administração do Microsoft Entra como pelo menos um Administrador de Grupos.

  2. Selecione Microsoft Entra ID.

  3. Selecione Grupos.

  4. Na lista Todos os grupos , abra o grupo que você deseja alterar.

  5. Selecione Propriedades.

  6. Na página Propriedades do grupo, selecione um valor para o tipo de associação: Atribuído (estático),Usuário Dinâmico ou Dispositivo Dinâmico, dependendo do tipo de associação desejado. Para grupos de associação dinâmica, é possível usar o construtor de regras para selecionar opções para uma regra simples ou gravar uma regra de associação por conta própria.

    As etapas a seguir são um exemplo de alteração de um grupo de usuários de grupos de associação estática para dinâmica:

    1. Para o tipo associação, selecione Usuário Dinâmico. Na caixa de diálogo que explica as alterações nos grupos de associação dinâmica, selecione Sim para continuar.

      Captura de tela da seleção de um tipo de associação de usuário dinâmico.

    2. Selecione Adicionar consulta dinâmica e, em seguida, forneça a regra.

      Captura de tela da inserção de uma regra para um grupo dinâmico.

  7. Depois de criar a regra, selecione Adicionar consulta.

  8. Na página Propriedades do grupo, selecione Salvar para salvar suas alterações. O Tipo de Associação do grupo é imediatamente atualizado na lista de grupos.

Dica

A conversão de grupo poderá falhar se a regra de associação que você inseriu estiver incorreta. No canto superior direito do portal, uma notificação explica por que a regra não pode ser aceita. Leia com atenção para entender como você pode ajustar a regra para torná-la válida. Para obter exemplos de sintaxe de regra e uma lista completa de propriedades com suporte, operadores e valores para uma regra de associação, confira Gerenciar regras de grupos de associação dinâmica no Microsoft Entra ID.

Alterar o tipo de associação de um grupo (PowerShell)

Aqui está um exemplo de funções que alternam a gestão de adesão em um grupo existente. Este exemplo manipula corretamente a GroupTypes propriedade para preservar todos os valores que não estão relacionados a grupos de associação dinâmica.

#The moniker for dynamic membership groups, as used in the GroupTypes property of a group object
$dynamicGroupTypeString = "DynamicMembership"

function ConvertDynamicGroupToStatic
{
    Param([string]$groupId)

    #Existing group types
    [System.Collections.ArrayList]$groupTypes = (Get-MgGroup -GroupId $groupId).GroupTypes

    if($groupTypes -eq $null -or !$groupTypes.Contains($dynamicGroupTypeString))
    {
        throw "This group is already a static group. Aborting conversion.";
    }


    #Remove the type for dynamic membership groups, but keep the other type values
    $groupTypes.Remove($dynamicGroupTypeString)

    #Modify the group properties to make it a static group: change GroupTypes to remove the dynamic type, and then pause execution of the current rule
    Update-MgGroup -GroupId $groupId -GroupTypes $groupTypes.ToArray() -MembershipRuleProcessingState "Paused"
}

function ConvertStaticGroupToDynamic
{
    Param([string]$groupId, [string]$dynamicMembershipRule)

    #Existing group types
    [System.Collections.ArrayList]$groupTypes = (Get-MgGroup -GroupId $groupId).GroupTypes

    if($groupTypes -ne $null -and $groupTypes.Contains($dynamicGroupTypeString))
    {
        throw "This group is already a dynamic group. Aborting conversion.";
    }
    #Add the dynamic group type to existing types
    $groupTypes.Add($dynamicGroupTypeString)

    #Modify the group properties to make it a static group: change GroupTypes to add the dynamic type, start execution of the rule, and then set the rule
    Update-MgGroup -GroupId $groupId -GroupTypes $groupTypes.ToArray() -MembershipRuleProcessingState "On" -MembershipRule $dynamicMembershipRule
}

Para tornar um grupo estático, use este comando:

ConvertDynamicGroupToStatic "a58913b2-eee4-44f9-beb2-e381c375058f"

Para tornar um grupo dinâmico, use este comando:

ConvertStaticGroupToDynamic "a58913b2-eee4-44f9-beb2-e381c375058f" "user.displayName -startsWith ""Peter"""

Conteúdo relacionado