Verificar conformidade do dispositivo
Verificar o estado de conformidade de um dispositivo
Descrição
Este runbook obtém o estado de conformidade de um dispositivo gerenciado do Microsoft Intune. No modo simples, mostra o estado geral de conformidade e lista quaisquer políticas não conformes. No modo detalhado, também mostra quais configurações específicas estão falhando e o motivo de cada falha. Opcionalmente, um relatório com todos os detalhes de conformidade pode ser enviado por e-mail.
Configuração relativa ao envio de e-mail
Enviar um relatório por e-mail é opcional e só acontece quando um destinatário (EmailTo) é fornecido. O endereço do remetente é obtido a partir da RJReport.EmailSender configuração do Tenant.
Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails via API do Graph, você precisa configurar um endereço de e-mail existente na personalização do runbook.
Consulte a documentação de configurações de relatório do RealmJoin para obter detalhes sobre todas as configurações disponíveis.
Identidade visual do e-mail
O e-mail do relatório respeita as configurações opcionais RJReport.Branding.* do Tenant:
Imagem do cabeçalho e 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 essas configurações não estão definidas, são usadas as imagens e cores padrão do RealmJoin. Uma imagem que não possa ser baixada ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório – o padrão correspondente é usado em seu lugar.
Instruções de configuração e requisitos de imagem: Identidade visual do e-mail.
Localização
Dispositivo → Geral → Verificar conformidade do dispositivo
Nome completo do Runbook
rjgit-device_general_check-device-compliance
Detalhes
Versão
1.2.0
Módulos necessários
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
Agendável
não
Permissões
Permissões de aplicativo
Tipo: Microsoft Graph
DeviceManagementManagedDevices.Read.All
Lê o dispositivo gerenciado, os estados das políticas de conformidade e os estados das definições por política
Organization.Read.All
Lê /organization para o nome de exibição do Tenant mostrado no relatório de conformidade
Mail.Send (opcional — funcionalidade: relatório por e-mail)
Envia o e-mail do relatório de conformidade via Send-RjReportEmail quando EmailTo está configurado
Parâmetros
DeviceId
O ID do dispositivo do Entra ID do dispositivo de destino. Passado automaticamente pela plataforma RealmJoin.
Obrigatório
verdadeiro
Valor padrão
Tipo
Cadeia de caracteres
Oculto no portal
sim (definido previamente via personalização do runbook)
DetailedOutput
Selecione "Simples" (valor final: $false) para mostrar apenas o estado geral de conformidade e os nomes das políticas não conformes. Selecione "Detalhado" (valor final: $true) para mostrar também quais definições específicas estão falhando e o motivo de cada falha.
Obrigatório
falso
Valor padrão
Falso
Tipo
Booleano
Nome de exibição no portal
Modo de saída
Opções do portal
Simples - mostrar o estado geral de conformidade e as políticas não conformes
falso
Detalhado - mostrar as definições com falha e os motivos por política
verdadeiro
EmailTo
Opcional - se especificado, um relatório de conformidade será enviado para o(s) endereço(s) de e-mail fornecido(s). Pode ser um único endereço ou vários endereços separados por vírgula.
Obrigatório
falso
Valor padrão
Tipo
Cadeia de caracteres
Nome de exibição no portal
Endereço(s) de e-mail do destinatário (opcional)
EmailFrom
O endereço de e-mail do remetente. Isso precisa ser configurado na personalização do runbook.
Obrigatório
falso
Valor padrão
Tipo
Cadeia de caracteres
Oculto no portal
sim (definido previamente via personalização do runbook)
BrandingHeaderImageUrl
URL HTTPS pública opcional de uma imagem personalizada de cabeçalho (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Proveniente da configuração do Tenant RJReport.Branding.HeaderImageUrl. Quando vazia, é usada a imagem padrão de cabeçalho do RealmJoin.
Obrigatório
falso
Valor padrão
Tipo
Cadeia de caracteres
Oculto no portal
sim (definido previamente via personalização do runbook)
BrandingFooterImageUrl
URL HTTPS pública opcional de uma imagem personalizada de rodapé (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Proveniente da configuração do Tenant RJReport.Branding.FooterImageUrl. Quando vazia, é usada a imagem padrão de rodapé do RealmJoin.
Obrigatório
falso
Valor padrão
Tipo
Cadeia de caracteres
Oculto no portal
sim (definido previamente via personalização do runbook)
BrandingFooterLink
URL opcional para a qual a imagem do rodapé aponta. Proveniente da configuração do Tenant RJReport.Branding.FooterLink. Quando vazia, é usado o link padrão (https://www.realmjoin.com).
Obrigatório
falso
Valor padrão
Tipo
Cadeia de caracteres
Oculto no portal
sim (definido previamente via personalização do runbook)
BrandingAccentColor
Substituição opcional da cor de destaque (hexadecimal de 6 dígitos, por exemplo '#0052cc') para o modelo de e-mail do relatório. Proveniente da configuração do Tenant RJReport.Branding.AccentColor. Quando vazio ou inválido, é usada a cor de destaque padrão do RealmJoin.
Obrigatório
falso
Valor padrão
Tipo
Cadeia de caracteres
Oculto no portal
sim (definido previamente via personalização do runbook)
BrandingTextColor
Substituição opcional da cor do texto (hexadecimal de 6 dígitos) para o modelo de e-mail do relatório. Proveniente da configuração do Tenant RJReport.Branding.TextColor. Quando vazio ou inválido, é usada a cor de texto padrão do RealmJoin.
Obrigatório
falso
Valor padrão
Tipo
Cadeia de caracteres
Oculto no portal
sim (definido previamente via personalização do runbook)
Última atualização
Isto foi útil?