Relatório de dispositivos obsoletos agendado
Relatório agendado de dispositivos obsoletos com base na data da última atividade e na plataforma.
Descrição
Identifica e lista dispositivos que não estiveram ativos durante um número especificado de dias. Envia automaticamente um relatório por e-mail com anexos CSV e/ou Excel (xlsx). Os ficheiros do relatório também podem ser carregados para uma Azure Storage Account, devolvendo links de download com tempo limitado. O parâmetro ReportFileFormat controla quais formatos de ficheiro são gerados e entregues (apenas CSV, CSV e XLSX, ou apenas XLSX). Quando o anexo CSV excede o limite de tamanho do e-mail e "CSV e XLSX" está selecionado, o e-mail recorre apenas à pasta de trabalho do Excel.
Configuração relativa ao envio de e-mails
O envio de um relatório por e-mail é opcional e só acontece quando um destinatário (EmailTo) é fornecido. O endereço do remetente é obtido da RJReport.EmailSender configuração do Tenant.
Este Runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails através da API do Microsoft Graph, é necessário 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 detalhes sobre todas as definições disponíveis.
Branding do e-mail
O e-mail do relatório respeita a configuração opcional RJReport.Branding.* do Tenant:
Imagem de cabeçalho e rodapé – URLs públicas HTTPS, PNG/JPEG/GIF, máx. 200 KB cada
Ligação do rodapé – destino da imagem de rodapé
Cor de acento e texto – valores hexadecimais de 6 dígitos, por exemplo
#0052cc
Quando estas definições não estão configuradas, são usados os gráficos e cores padrão do RealmJoin. Uma imagem que não possa ser descarregada 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 → Dispositivos → Report Stale Devices (Agendado)
Nome completo do Runbook
rjgit-org_devices_report-stale-devices_scheduled
Detalhes
Versão
1.5.0
Módulos necessários
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)
Agendável
sim
Notas
Este runbook gera um relatório abrangente de dispositivos inativos e entrega-o por e-mail. O relatório inclui detalhes do dispositivo, repartições por plataforma e exporta ficheiros de relatório (CSV/xlsx) para análise adicional.
Pré-requisitos:
O parâmetro EmailFrom deve ser configurado na personalização do runbook (definição RJReport.EmailSender)
Casos de uso comuns:
Auditorias regulares ao inventário de dispositivos e relatórios de conformidade
Identificar dispositivos para reforma ou desativação
Revisões de segurança para encontrar dispositivos potencialmente perdidos
Monitorizar a integridade dos dispositivos em toda a organização
Usar o parâmetro MaxDays para relatórios em etapas (por exemplo, 30-60 dias, 60-90 dias)
Filtragem do âmbito do utilizador para focar departamentos específicos ou excluir contas de serviço
O runbook suporta filtragem opcional do âmbito do utilizador para incluir ou excluir dispositivos com base na filiação ao grupo do utilizador principal.
Permissões
Permissões da aplicação
Tipo: Microsoft Graph
DeviceManagementManagedDevices.Read.All
Lista dispositivos Intune filtrados por lastSyncDateTime para encontrar dispositivos inativos
Directory.Read.All
Lê os membros dos grupos de inclusão/exclusão, os detalhes do utilizador principal e o nome do Tenant
Mail.Send (opcional — funcionalidade: relatório por e-mail)
Envia o e-mail do relatório através de Send-RjReportEmail quando EmailTo está configurado
Parâmetros
Dias
Número de dias sem atividade para ser considerado inativo.
Obrigatório
falso
Valor predefinido
30
Tipo
Int32
Nome de exibição no portal
Dias Mínimos Sem Atividade
MaxDays
Número máximo opcional de dias sem atividade. Se definido, apenas serão incluídos dispositivos inativos entre Days e MaxDays.
Obrigatório
falso
Valor predefinido
Tipo
Int32
Nome de exibição no portal
(Opcional) Dias Máximos Sem Atividade
Windows
Incluir dispositivos Windows nos resultados.
Obrigatório
falso
Valor predefinido
Verdadeiro
Tipo
Booleano
Nome de exibição no portal
Incluir Dispositivos Windows
MacOS
Incluir dispositivos macOS nos resultados.
Obrigatório
falso
Valor predefinido
Verdadeiro
Tipo
Booleano
Nome de exibição no portal
Incluir Dispositivos macOS
iOS
Incluir dispositivos iOS nos resultados.
Obrigatório
falso
Valor predefinido
Verdadeiro
Tipo
Booleano
Nome de exibição no portal
Incluir Dispositivos iOS
Android
Incluir dispositivos Android nos resultados.
Obrigatório
falso
Valor predefinido
Verdadeiro
Tipo
Booleano
Nome de exibição no portal
Incluir Dispositivos Android
EmailFrom
O endereço de email do remetente. Isto precisa de ser configurado na personalização do runbook
Obrigatório
falso
Valor predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
BrandingHeaderImageUrl
URL HTTPS pública opcional de uma imagem de cabeçalho personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.HeaderImageUrl. Quando vazio, é usada a imagem de cabeçalho padrão do RealmJoin.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
BrandingFooterImageUrl
URL HTTPS pública opcional de uma imagem de rodapé personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.FooterImageUrl. Quando vazio, é usada a imagem de rodapé padrão do RealmJoin.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
BrandingFooterLink
URL opcional para a qual a imagem de rodapé aponta. Obtida da configuração do Tenant RJReport.Branding.FooterLink. Quando vazio, é usada a ligação padrão (https://www.realmjoin.com).
Obrigatório
falso
Valor predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
BrandingAccentColor
Substituição opcional da cor de acento (hex de 6 dígitos, por exemplo '#0052cc') para o modelo de e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.AccentColor. Quando vazio ou inválido, é usada a cor de acento padrão do RealmJoin.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
BrandingTextColor
Substituição opcional da cor do texto (hex de 6 dígitos) para o modelo de e-mail do relatório. Obtida 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 predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
ReportFileFormat
Controla quais formatos de ficheiro do relatório são gerados e entregues: "Apenas CSV", "CSV e XLSX" (predefinição) ou "Apenas XLSX".
Obrigatório
falso
Valor predefinido
CSV e XLSX
Tipo
Texto
Nome de exibição no portal
Formato do arquivo do relatório
Opções do portal
CSV e XLSX
Somente CSV
Somente XLSX
CreateDownloadLink
Se ativado, os ficheiros do relatório são carregados para uma Storage Account do Azure e são devolvidos links de download com validade limitada. Desativado por predefinição.
Obrigatório
falso
Valor predefinido
Falso
Tipo
Booleano
Nome de exibição no portal
Criar um link de download do ficheiro (carregar relatório para o armazenamento)?
Opções do portal
Sim - carregar o relatório e devolver um link de download
verdadeiro
Não - não criar um link de download
falso
ContainerName
Nome do contentor de armazenamento usado para o carregamento. Configurado por runbook (não uma definição global do RJReport).
Obrigatório
falso
Valor predefinido
report-stale-devices
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
ResourceGroupName
Grupo de recursos que contém a Storage Account. Obtido das definições do Tenant RJReport.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
StorageAccountName
Nome da Storage Account usado para o carregamento. Obtido das definições do Tenant RJReport.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Oculto no portal
sim (predefinido através da personalização do runbook)
LinkExpiryDays
Número de dias até o link de download gerado expirar. Obtido das definições do Tenant RJReport.
Obrigatório
falso
Valor predefinido
6
Tipo
Int32
Oculto no portal
sim (predefinido através da personalização do runbook)
UseUserScope
Ativa a filtragem do âmbito do utilizador para incluir ou excluir dispositivos com base na filiação ao grupo do utilizador principal.
Obrigatório
falso
Valor predefinido
Falso
Tipo
Booleano
Nome de exibição no portal
Usar Filtragem do Âmbito do Utilizador
Oculto no portal
sim (predefinido através da personalização do runbook)
IncludeUserGroup
Inclui apenas dispositivos cujos utilizadores principais são membros deste grupo. Requer que UseUserScope esteja ativado.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Nome de exibição no portal
Utilizadores a incluir (Grupo)
Oculto no portal
sim (predefinido através da personalização do runbook)
ExcludeUserGroup
Exclui dispositivos cujos utilizadores principais são membros deste grupo. Requer que UseUserScope esteja ativado.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Nome de exibição no portal
Utilizadores a excluir (Grupo)
Oculto no portal
sim (predefinido através da personalização do runbook)
EmailTo
Se especificado, será enviado um e-mail com o relatório para o(s) endereço(s) fornecido(s). Pode ser um único endereço ou vários endereços separados por vírgulas (string). A função envia e-mails individuais para cada destinatário por motivos de privacidade.
Obrigatório
falso
Valor predefinido
Tipo
Texto
Nome de exibição no portal
Endereço(s) de e-mail do destinatário
Última atualização
Isto foi útil?