Adicionar utilizadores principais de dispositivos a um grupo agendado
Manter um grupo sincronizado com os utilizadores principais de dispositivos do Intune
Descrição
Recolhe os utilizadores primários de todos os dispositivos Intune das plataformas escolhidas e mantém um grupo do Entra ID sincronizado com eles. Os utilizadores sem um dispositivo correspondente são removidos, a menos que a remoção esteja desativada. Um grupo de inclusão limita quais utilizadores são elegíveis; um grupo de exclusão bloqueia utilizadores. Um modo apenas de relatório antevê as alterações por email sem aplicar nada.
Casos de uso comuns
Manter um grupo de destino de distribuição ou de Conditional Access alinhado com "quem atualmente tem um dispositivo gerido", filtrado por plataforma, por um filtro OData avançado ou por um âmbito de grupo de inclusão/exclusão.
Validar um filtro ou âmbito novo ou alterado antes de poder escrever num grupo de produção.
Recomenda-se um agendamento diário.
Modo apenas de relatório para pilotos e testes
Ativar ApenasRelatório para calcular a mesma diferença de adição/remoção que uma execução real produziria, sem aplicar qualquer alteração ao grupo. Em vez disso, é enviado um email de pré-visualização em Markdown que lista os utilizadores afetados por UPN para EmailTo: cada lista (seriam adicionados, seriam removidos) mostra no máximo 10 utilizadores no corpo do email, com um indicador "... e mais N" quando uma lista é mais longa, e as listas completas são anexadas como ficheiro(s) de relatório no formato escolhido por ReportFileFormat. Execute uma vez neste modo após alterar a seleção da plataforma, FiltroAvançado ou os grupos de inclusão/exclusão, reveja a pré-visualização e depois desative ApenasRelatório para permitir que a sincronização seja aplicada.
Interações entre parâmetros
FiltroAvançado, quando definido, substitui completamente a seleção de plataforma Windows/macOS/iOS/Android em vez de a combinar com ela.RemoverUtilizadoresQuandoNaoExisteCorrespondênciaDeDispositivocontrola tanto a execução real como aApenasRelatóriopré-visualização: quando desativado, nenhum utilizador é removido em qualquer dos casos, pelo que a pré-visualização reflete sempre o que uma execução real faria.
Configuração relativa ao envio de e-mail
O envio de um relatório por e-mail é opcional e só acontece quando a ApenasRelatório opção está ativada; um destinatário (EmailTo). O endereço do remetente é obtido a partir da RJReport.EmailSender definição do Tenant.
Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails via API Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.
Veja a documentação das definições de relatório do RealmJoin para obter detalhes sobre todas as definições disponíveis.
Branding do e-mail
O e-mail do relatório respeita as RJReport.Branding.* definições opcionais do Tenant:
Imagem do cabeçalho e do rodapé – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
Link do rodapé – destino da imagem do rodapé
Cor de destaque e do texto – valores hexadecimais de 6 dígitos, por exemplo
#0052cc
Quando estas definições não estão configuradas, são usadas as imagens e cores padrão do RealmJoin. Uma imagem que não pode ser transferida ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório – em vez disso, é usado o padrão correspondente.
Instruções de configuração e requisitos de imagem: Branding do e-mail.
Localização
Organização → Geral → Adicionar Utilizadores Primários dos Dispositivos ao Grupo (Agendado)
Nome completo do runbook
rjgit-org_general_add-primary-users-of-devices-to-group_scheduled
Detalhes
Versão
1.2.0
Módulos necessários
RealmJoin.RunbookHelper (>= 0.8.10) Microsoft.Graph.Authentication (>= 2.41.2)
Agendável
sim
Permissões
Permissões de aplicativo
Tipo: Microsoft Graph
DeviceManagementManagedDevices.Read.All
Lê dispositivos geridos pelo Intune filtrados por SO para recolher o utilizador primário de cada dispositivo
Group.Read.All
Valida os grupos de destino/inclusão/exclusão e lê as respetivas listas de membros
GroupMember.ReadWrite.All
Adiciona e remove utilizadores no grupo de destino através de chamadas /groups/{id}/members/$ref em lote
User.Read.All
Lê o ID do membro e o UPN para identificar membros do tipo utilizador e registar remoções
Parâmetros
TargetGroupId
Grupo que recebe os utilizadores primários. A sua associação é gerida apenas por este runbook.
Obrigatório
verdadeiro
Valor padrão
Tipo
Texto
Nome de exibição no portal
Grupo de destino
Windows
Inclui os utilizadores primários de dispositivos Windows.
Obrigatório
falso
Valor padrão
Falso
Tipo
Booleano
Nome de exibição no portal
Incluir dispositivos Windows?
MacOS
Inclui os utilizadores primários de dispositivos macOS.
Obrigatório
falso
Valor padrão
Falso
Tipo
Booleano
Nome de exibição no portal
Incluir dispositivos macOS?
iOS
Inclui os utilizadores primários de dispositivos iOS e iPadOS.
Obrigatório
falso
Valor padrão
Falso
Tipo
Booleano
Nome de exibição no portal
Incluir dispositivos iOS?
Android
Inclui os utilizadores primários de dispositivos Android.
Obrigatório
falso
Valor padrão
Falso
Tipo
Booleano
Nome de exibição no portal
Incluir dispositivos Android?
FiltroAvançado
Filtro OData para os dispositivos em vez dos seletores de plataforma, por exemplo startsWith(deviceName,'FWP-') and operatingSystem eq 'Windows'.
Obrigatório
falso
Valor padrão
Tipo
Texto
Nome de exibição no portal
Filtro personalizado
RemoverUtilizadoresQuandoNaoExisteCorrespondênciaDeDispositivo
Remove os utilizadores do grupo de destino quando já não forem o utilizador primário de um dispositivo correspondente. Desative para apenas adicionar.
Obrigatório
falso
Valor padrão
Verdadeiro
Tipo
Booleano
Nome de exibição no portal
Remover utilizadores sem um dispositivo correspondente?
ID do grupo de inclusão
Apenas os membros deste grupo podem ser adicionados ao grupo de destino.
Obrigatório
falso
Valor padrão
Tipo
Texto
Nome de exibição no portal
Incluir utilizadores do grupo
Oculto no portal
sim (predefinido por meio da personalização do runbook)
ExcludeGroupId
Os membros deste grupo nunca são adicionados e são removidos, se estiverem presentes.
Obrigatório
falso
Valor padrão
Tipo
Texto
Nome de exibição no portal
Excluir utilizadores do grupo
Oculto no portal
sim (predefinido por meio da personalização do runbook)
ApenasRelatório
Pré-visualiza as alterações sem as aplicar. A pré-visualização é enviada por email, com os primeiros 10 utilizadores por lista no corpo e as listas completas anexadas.
Obrigatório
falso
Valor padrão
Falso
Tipo
Booleano
Nome de exibição no portal
Apenas relatório?
EmailFrom
Endereço do remetente do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.EmailSender.
Obrigatório
falso
Valor padrão
Tipo
Texto
Oculto no portal
sim (predefinido por meio da personalização do runbook)
BrandingHeaderImageUrl
Imagem do cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.HeaderImageUrl; o cabeçalho padrão do RealmJoin é usado quando está vazio.
Obrigatório
falso
Valor padrão
Tipo
Texto
Oculto no portal
sim (predefinido por meio da personalização do runbook)
BrandingFooterImageUrl
Imagem do rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.FooterImageUrl; o rodapé padrão do RealmJoin é usado quando está vazio.
Obrigatório
falso
Valor padrão
Tipo
Texto
Oculto no portal
sim (predefinido por meio da personalização do runbook)
BrandingFooterLink
Link por trás da imagem do rodapé do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é usado quando está vazio.
Obrigatório
falso
Valor padrão
Tipo
Texto
Oculto no portal
sim (predefinido por meio da personalização do runbook)
BrandingAccentColor
Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.AccentColor; o padrão do RealmJoin é usado quando está vazio ou inválido.
Obrigatório
falso
Valor padrão
Tipo
Texto
Oculto no portal
sim (predefinido por meio da personalização do runbook)
BrandingTextColor
Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.TextColor; o padrão do RealmJoin é usado quando está vazio ou inválido.
Obrigatório
falso
Valor padrão
Tipo
Texto
Oculto no portal
sim (predefinido por meio da personalização do runbook)
EmailTo
Endereço para o qual vai a pré-visualização. Utilizado apenas no modo apenas de relatório.
Obrigatório
falso
Valor padrão
Tipo
Texto
Nome de exibição no portal
Enviar relatório de pré-visualização para
ReportFileFormat
Anexe as listas completas como CSV, como uma pasta de trabalho do Excel ou ambos. Utilizado apenas no modo apenas de relatório.
Obrigatório
falso
Valor padrão
CSV e XLSX
Tipo
Texto
Nome de exibição no portal
Formato do ficheiro do relatório de pré-visualização
Opções do portal
CSV e XLSX
CSV e XLSX
Somente CSV
Somente CSV
Somente XLSX
Somente XLSX
Última atualização
Isto foi útil?