Relatório de dispositivos obsoletos agendado

Relatório agendado de dispositivos obsoletos com base na data da última atividade e na plataforma.

Este é um Runbook agendado. Foi concebido para ser executado segundo um agendamento recorrente, em vez de ser acionado para um único objeto. Consulte Agendamento para detalhes sobre como configurar os agendamentos do Runbook.

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

Propriedade

Valor

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.

Propriedade

Valor

Obrigatório

falso

Valor predefinido

Tipo

Int32

Nome de exibição no portal

Dias Mínimos Sem Atividade

O endereço de email do remetente. Isto precisa de ser configurado na personalização do runbook

Propriedade

Valor

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.

Propriedade

Valor

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.

Propriedade

Valor

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).

Propriedade

Valor

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.

Propriedade

Valor

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.

Propriedade

Valor

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".

Propriedade

Valor

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

Opção do portal

Valor

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.

Propriedade

Valor

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

Opção do portal

Valor

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).

Propriedade

Valor

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.

Propriedade

Valor

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.

Propriedade

Valor

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.

Propriedade

Valor

Obrigatório

falso

Valor predefinido

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.

Propriedade

Valor

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.

Propriedade

Valor

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.

Propriedade

Valor

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.

Propriedade

Valor

Obrigatório

falso

Valor predefinido

Tipo

Texto

Nome de exibição no portal

Endereço(s) de e-mail do destinatário

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

Última atualização há 8 dias

Isto foi útil?