Adicionar utilizadores principais de dispositivos ao grupo agendado

Sincronizar os utilizadores principais de dispositivos geridos pelo Intune por plataforma para um grupo Entra ID

Este é um runbook agendado. Ele foi projetado para ser executado em uma agenda recorrente, em vez de ser acionado para um único objeto. Veja Agendamento para obter detalhes sobre como configurar agendas de runbooks.

Descrição

Este runbook coleta os usuários primários de todos os dispositivos gerenciados pelo Intune que correspondem à(s) plataforma(s) selecionada(s) e os sincroniza em um grupo de destino do Entra ID. Usuários que não estejam mais atribuídos como usuário primário em nenhum dispositivo correspondente são removidos do grupo. Um grupo de inclusão opcional restringe quais usuários são elegíveis, e um grupo de exclusão opcional impede que usuários específicos sejam adicionados ou mantém sua remoção.

Localização

Organização → Geral → Adicionar Usuários Primários De Dispositivos Ao Grupo (Agendado)

Nome completo do Runbook

rjgit-org_general_add-primary-users-of-devices-to-group_scheduled

Detalhes

Propriedade	Valor
Versão	1.0.3
Módulos necessários	RealmJoin.RunbookHelper (>= 0.8.7) Microsoft.Graph.Authentication (>= 2.39.0)
Agendável	sim

Permissões

Permissões da aplicação

• Tipo: Microsoft Graph

  • DeviceManagementManagedDevices.Read.All
  • Group.Read.All
  • GroupMember.ReadWrite.All
  • User.Read.All

Parâmetros

TargetGroupId

O grupo do Entra ID no qual os usuários primários serão sincronizados. Os membros deste grupo serão gerenciados exclusivamente por este runbook.

Propriedade	Valor
Obrigatório	verdadeiro
Valor predefinido
Tipo	Cadeia de caracteres
Nome de exibição no portal	Grupo de destino (sincronizar usuários primários para este grupo)

Windows

Incluir usuários primários de dispositivos Windows. (Filtro OData usado "operatingSystem eq 'Windows'")

Propriedade	Valor
Obrigatório	falso
Valor predefinido	Falso
Tipo	Booleano
Nome de exibição no portal	Incluir dispositivos Windows

macOS

Incluir usuários primários de dispositivos macOS. (Filtro OData usado "operatingSystem eq 'macOS'")

Propriedade	Valor
Obrigatório	falso
Valor predefinido	Falso
Tipo	Booleano
Nome de exibição no portal	Incluir dispositivos macOS

iOS

Incluir usuários primários de dispositivos iOS e iPadOS. (Filtro OData usado "operatingSystem eq 'iOS'")

Propriedade	Valor
Obrigatório	falso
Valor predefinido	Falso
Tipo	Booleano
Nome de exibição no portal	Incluir dispositivos iOS

Android

Incluir usuários primários de dispositivos Android. (Filtro OData usado "operatingSystem eq 'Android'")

Propriedade	Valor
Obrigatório	falso
Valor predefinido	Falso
Tipo	Booleano
Nome de exibição no portal	Incluir dispositivos Android

FiltroAvançado

Opcional. Filtro OData personalizado a aplicar ao recuperar dispositivos. Substitui os filtros baseados na plataforma, se fornecido. Exemplo: startsWith(deviceName,'FWP-') and operatingSystem eq 'Windows' .

Propriedade	Valor
Obrigatório	falso
Valor predefinido
Tipo	Cadeia de caracteres
Nome de exibição no portal	Filtro personalizado (substitui a seleção de SO)

RemoveUsersWhenNoDeviceMatch

Quando ativado (padrão), os usuários que já não têm um dispositivo primário correspondente à(s) plataforma(s) selecionada(s) são removidos do grupo de destino. Desative para o modo somente adição — os membros existentes nunca são removidos.

Propriedade	Valor
Obrigatório	falso
Valor predefinido	Verdadeiro
Tipo	Booleano
Nome de exibição no portal	Remover usuários que já não têm um dispositivo correspondente

IncludeGroupId

Opcional. Apenas os usuários que forem membros deste grupo podem ser adicionados ao grupo de destino. Deixe em branco para considerar todos os usuários primários.

Propriedade	Valor
Obrigatório	falso
Valor predefinido
Tipo	Cadeia de caracteres
Nome de exibição no portal	Incluir usuários do grupo (opcional)
Oculto no portal	sim (predefinido via personalização do runbook)

ExcludeGroupId

Opcional. Usuários que forem membros deste grupo não serão adicionados e serão removidos do grupo de destino se já estiverem presentes.

Propriedade	Valor
Obrigatório	falso
Valor predefinido
Tipo	Cadeia de caracteres
Nome de exibição no portal	Excluir usuários do grupo (opcional)
Oculto no portal	sim (predefinido via personalização do runbook)

Voltar à visão geral da referência do Runbook