> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/org/security/report-epm-elevation-requests_scheduled.md).
# Relatório de pedidos de elevação do EPM agendado
Reportar pedidos de elevação do EPM por estado e antiguidade
{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}
### Descrição
Recolhe as solicitações de elevação do Endpoint Privilege Management do Intune, filtradas por estado e por há quanto tempo foram criadas. As solicitações são listadas por estado com um resumo das contagens. O Intune mantém os detalhes das solicitações durante 30 dias, pelo que as solicitações mais antigas não podem ser incluídas no relatório. O relatório pode ser enviado por email ou disponibilizado como uma ligação de transferência.
### Finalidade e casos de uso
* Relatórios regulares das atividades do Endpoint Privilege Management (EPM)
* Trilha de auditoria para solicitações de elevação aprovadas e negadas
* Análise de solicitações expiradas para identificar gargalos de processo
* Identificação de aplicações frequentemente solicitadas para regras de elevação automática
É recomendado um agendamento mensal.
### Tipos de estado
* **Pendente:** aguarda a decisão de um administrador (use **Monitorar solicitações pendentes de EPM** para alertas críticos em termos de tempo)
* **Aprovado:** um administrador aprovou a solicitação, o utilizador pode prosseguir com a elevação
* **Negado:** um administrador rejeitou a solicitação devido a preocupações de segurança ou de política
* **Expirado:** a solicitação expirou antes de um administrador a analisar, o que pode indicar tempos de resposta lentos
* **Revogado:** uma elevação previamente aprovada foi posteriormente revogada por um administrador
* **Concluído:** o utilizador executou com êxito a aplicação elevada após a aprovação
### Retenção de dados e intervalos de tempo
* O Intune retém os detalhes das solicitações de EPM durante 30 dias após a criação.
* Para análise a longo prazo, arquive as exportações CSV fora do Intune.
* O filtro predefinido abrange os estados Aprovado, Negado, Expirado e Revogado nos últimos 30 dias.
### Saída e ficheiros do relatório
* O separador Dados de saída da execução mostra uma *Resumo* tabela com as contagens e uma tabela por estado selecionado (por exemplo *Solicitações aprovadas*), com a solicitação mais antiga primeiro.
* Os ficheiros do relatório contêm todas as solicitações correspondentes com todos os detalhes: carimbos de data/hora, utilizadores, dispositivos, aplicações, justificação e hashes de ficheiro. São gerados em CSV e/ou Excel (xlsx), dependendo do formato de ficheiro do relatório selecionado.
* Os emails são enviados individualmente a cada destinatário para proteger a privacidade.
* Não é enviado qualquer email nem criado qualquer ficheiro quando nenhuma solicitação corresponde aos critérios do filtro. Essa execução termina normalmente; o separador Dados de saída continua a mostrar o resumo.
### Entrega do relatório
Os ficheiros do relatório só são gerados quando um método de entrega é selecionado através da **Entrega do relatório** opção (email e/ou ligação de transferência). Com *Apenas dados de saída* selecionado, os resultados são lidos diretamente na aba Output Data do portal RealmJoin, onde cada tabela também pode ser exportada para o Excel. A entrega por e-mail e a geração de link de download são independentes e podem ser combinadas.
Para a ligação de transferência, os ficheiros do relatório são carregados para a Storage Account do Azure configurada nas `RJReport.StorageAccount.*` definições de Tenant, e são devolvidos links de download SAS com prazo limitado. O carregamento para o armazenamento autentica-se com a identidade gerida da conta de Automação; essa identidade precisa da **Leitor e acesso aos dados** função RBAC na Storage Account de destino (isto é uma atribuição de Azure RBAC, não uma permissão de aplicação do Graph).
Os agendamentos criados antes da **Entrega do relatório** opção existir continuam a enviar o respetivo email: um destinatário guardado por si só ainda ativa o email para eles. Quando esse agendamento é aberto para edição, a opção mostra *Apenas dados de saída*; selecione novamente a entrega antes de guardar, caso contrário o agendamento deixa de enviar o relatório.
### Configuração relativa ao envio de emails
O envio de um relatório por email é opcional e só acontece quando *Enviar também o relatório por email* ou *Enviar também email e ligação de transferência* é selecionado como entrega do relatório; nesse caso é necessário um destinatário. O endereço do remetente é obtido de `RJReport.EmailSender` Tenant.
Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é 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](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis.
#### Branding do email
O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant:
* **Imagem do cabeçalho e do rodapé** - URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação no rodapé** - destino da imagem de 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 predefinidas de RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório - em vez disso, é usada a predefinição correspondente.
Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
### Localização
Organização → Segurança → Relatar solicitações de elevação EPM (Agendado)
**Nome completo do Runbook**
rjgit-org\_security\_report-EPM-elevation-requests\_scheduled
### Detalhes
| Propriedade | Valor |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Versão | 1.4.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Agendável | sim |
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* DeviceManagementConfiguration.Read.All
* *Consulta elevationRequests do Endpoint Privilege Management por estado e data de criação para gerar o relatório*
* Mail.Send *(opcional — funcionalidade: Relatório por email)*
* *Envia o email do relatório com anexos CSV/XLSX através de Send-RjRbReportEmail quando a entrega por email é selecionada*
* Organization.Read.All *(opcional — funcionalidade: Relatório por email)*
* *Lê o nome de apresentação e o ID do tenant para o assunto do email, o corpo do email e os nomes dos ficheiros do relatório*
#### Notas de permissão
Azure Storage Account: função 'Leitor e acesso aos dados' para a identidade gerida da conta de Automação na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (necessário apenas para as opções de ligação de transferência)
### Parâmetros
#### IncludeApproved
Inclui solicitações aprovadas por um administrador.
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir solicitações aprovadas? |
#### IncludeDenied
Inclui solicitações rejeitadas por um administrador.
| Propriedade | Valor |
| -------------------------- | -------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir solicitações rejeitadas? |
#### IncludeExpired
Inclui solicitações que expiraram antes de ser tomada uma decisão.
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir solicitações expiradas? |
#### IncludeRevoked
Inclui solicitações cuja aprovação foi posteriormente revogada.
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir solicitações revogadas? |
#### IncludePending
Inclui solicitações que ainda aguardam uma decisão.
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir solicitações pendentes? |
#### IncludeCompleted
Inclui solicitações que foram aprovadas e utilizadas.
| Propriedade | Valor |
| -------------------------- | -------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir solicitações concluídas? |
#### IdadeMáximaEmDias
Só são reportadas as solicitações criadas dentro deste número de dias. O Intune mantém os detalhes das solicitações durante 30 dias, pelo que um valor superior é reduzido para 30.
| Propriedade | Valor |
| -------------------------- | ------------------------ |
| Obrigatório | falso |
| Valor predefinido | 30 |
| Tipo | Int32 |
| Nome de exibição do portal | Criadas dentro de (dias) |
#### SendEmailReport
Envia o relatório para o endereço de email do destinatário.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### EmailTo
Enviar o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um email separado.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Endereço(s) de email do(s) destinatário(s) |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### EmailFrom
Endereço do remetente do email do relatório. Obtido da definição do Tenant RJReport.EmailSender.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingHeaderImageUrl
Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterImageUrl
Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterLink
Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingAccentColor
Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingTextColor
Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ReportFileFormat
Entregar o relatório como CSV, como uma pasta de trabalho do Excel ou ambos.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | CSV e XLSX |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Formato do ficheiro do relatório |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
**Opções do portal**
| Opção do portal | Valor |
| --------------- | ----------- |
| CSV e XLSX | CSV e XLSX |
| Apenas CSV | Apenas CSV |
| Apenas XLSX | Apenas XLSX |
#### CreateDownloadLink
Também carregue o relatório e devolva uma ligação de download que expira após alguns dias.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ContainerName
Contentor de armazenamento para o qual os ficheiros do relatório são carregados. Definir por runbook.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | report-epm-elevation-requests |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ResourceGroupName
Grupo de recursos da conta de armazenamento para carregamentos do relatório. Obtido a partir da definição de tenant RJReport.StorageAccount.ResourceGroup.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### StorageAccountName
Conta de armazenamento para carregamentos do relatório. Obtida a partir da definição de tenant RJReport.StorageAccount.StorageAccountName.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### LinkExpiryDays
Número de dias que uma ligação de download permanece válida. Obtido a partir da definição de tenant RJReport.StorageAccount.LinkExpiryDays.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | 6 |
| Tipo | Int32 |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
[Voltar à visão geral da referência do Runbook](/pt/automatizacao/runbooks/runbook-references.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/org/security/report-epm-elevation-requests_scheduled.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.