Relatório agendado de dispositivos desatualizados
Relatório agendado de dispositivos desatualizados com base na data da última atividade e na plataforma.
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
Identifica e lista dispositivos que não estiveram ativos por um número especificado de dias. Envia automaticamente um relatório por e-mail com anexos CSV e/ou Excel (xlsx). Os arquivos do relatório também podem ser enviados para um Azure Storage Account, retornando links de download com prazo limitado. O parâmetro ReportFileFormat controla quais formatos de arquivo são gerados e entregues (somente CSV, CSV e XLSX, ou somente XLSX). Quando o anexo CSV excede o limite de tamanho do e-mail e "CSV & XLSX" é selecionado, o e-mail faz fallback para apenas a pasta de trabalho do Excel.
Configuração relativa ao envio de emails
O envio de um relatório por email é opcional e só acontece quando é fornecido um destinatário (E-mail para) . O endereço do remetente é obtido da RJReport.EmailSender configuração do Tenant.
Este runbook envia emails usando a API Microsoft Graph. Para enviar emails através da API Graph, é necessário configurar um endereço de email existente na personalização do runbook.
Consulte a documentação das definições de relatório do RealmJoin para obter detalhes.
Localização
Organização → Dispositivos → Relatar Dispositivos Inativos (Agendado)
Nome completo do Runbook
rjgit-org_devices_report-stale-devices_scheduled
Detalhes
Versão
1.3.0
Módulos necessários
RealmJoin.RunbookHelper (>= 0.8.7) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.3.4)
Agendável
sim
Notas
Este runbook gera um relatório abrangente de dispositivos inativos e o entrega por e-mail. O relatório inclui detalhes dos dispositivos, detalhamentos por plataforma e exporta arquivos de relatório (CSV/xlsx) para análise adicional.
Pré-requisitos:
O parâmetro EmailFrom deve ser configurado na personalização do runbook (configuração RJReport.EmailSender)
Casos de uso comuns:
Auditorias regulares do inventário de dispositivos e relatórios de conformidade
Identificar dispositivos para aposentadoria ou descomissionamento
Revisões de segurança para encontrar dispositivos potencialmente perdidos
Monitoramento da integridade dos dispositivos em toda a organização
Uso do parâmetro MaxDays para relatórios em etapas (por exemplo, 30-60 dias, 60-90 dias)
Filtragem do escopo do usuário para focar em departamentos específicos ou excluir contas de serviço
O runbook oferece suporte opcional à filtragem do escopo do usuário para incluir ou excluir dispositivos com base na associação ao grupo do usuário primário.
Permissões
Permissões da aplicação
Tipo: Microsoft Graph
DeviceManagementManagedDevices.Read.All
Directory.Read.All
Device.Read.All
Mail.Send
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, somente dispositivos inativos entre Days e MaxDays serão incluídos.
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
E-mail do remetente
O endereço de e-mail do remetente. Isto precisa de ser configurado na personalização do runbook
Obrigatório
falso
Valor predefinido
Tipo
Cadeia de caracteres
Oculto no portal
sim (predefinido via personalização do runbook)
ReportFileFormat
Controla quais formatos de ficheiro de relatório são gerados e entregues: "CSV only", "CSV & XLSX" (predefinição) ou "XLSX only".
Obrigatório
falso
Valor predefinido
CSV & XLSX
Tipo
Cadeia de caracteres
Nome de exibição no portal
Formato do ficheiro de relatório
Opções do portal
CSV & XLSX
CSV only
XLSX only
CreateDownloadLink
Se ativado, os ficheiros de relatório são carregados para um Azure Storage Account e são devolvidas ligações de download com tempo limitado. Desativado por predefinição.
Obrigatório
falso
Valor predefinido
Falso
Tipo
Booleano
Nome de exibição no portal
Criar uma ligação de download do ficheiro (carregar relatório para o armazenamento)?
Opções do portal
Sim - carregar relatório e devolver uma ligação de download
verdadeiro
Não - não criar uma ligação de download
falso
ContainerName
Nome do contentor de armazenamento usado para o carregamento. Configurado por runbook (não é uma configuração global do RJReport).
Obrigatório
falso
Valor predefinido
report-stale-devices
Tipo
Cadeia de caracteres
Oculto no portal
sim (predefinido via personalização do runbook)
ResourceGroupName
Grupo de recursos que contém a conta de armazenamento. Obtido a partir das configurações do Tenant RJReport.
Obrigatório
falso
Valor predefinido
Tipo
Cadeia de caracteres
Oculto no portal
sim (predefinido via personalização do runbook)
StorageAccountName
Nome da conta de armazenamento usado para o carregamento. Obtido a partir das configurações do Tenant RJReport.
Obrigatório
falso
Valor predefinido
Tipo
Cadeia de caracteres
Oculto no portal
sim (predefinido via personalização do runbook)
LinkExpiryDays
Número de dias até a ligação de download gerada expirar. Obtido a partir das configurações do Tenant RJReport.
Obrigatório
falso
Valor predefinido
6
Tipo
Int32
Oculto no portal
sim (predefinido via personalização do runbook)
UseUserScope
Habilite a filtragem do escopo do usuário para incluir ou excluir dispositivos com base na associação ao grupo do usuário primário.
Obrigatório
falso
Valor predefinido
Falso
Tipo
Booleano
Nome de exibição no portal
Usar filtragem de escopo do usuário
Oculto no portal
sim (predefinido via personalização do runbook)
IncludeUserGroup
Incluir apenas dispositivos cujos usuários primários sejam membros deste grupo. Requer que UseUserScope esteja habilitado.
Obrigatório
falso
Valor predefinido
Tipo
Cadeia de caracteres
Nome de exibição no portal
Usuários a incluir (Grupo)
Oculto no portal
sim (predefinido via personalização do runbook)
ExcludeUserGroup
Excluir dispositivos cujos usuários primários sejam membros deste grupo. Requer que UseUserScope esteja habilitado.
Obrigatório
falso
Valor predefinido
Tipo
Cadeia de caracteres
Nome de exibição no portal
Usuários a excluir (Grupo)
Oculto no portal
sim (predefinido via personalização do runbook)
E-mail para
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
Cadeia de caracteres
Nome de exibição no portal
Endereço(s) de email do destinatário
Última atualização
Isto foi útil?