> 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/automacao/runbooks/runbook-references/org/applications/report-application-registration.md).

# Relatório de registo de aplicações

Gerar e enviar por email um relatório abrangente de registo de aplicações

### Descrição

Este runbook gera um relatório de todos os registos de aplicações em Microsoft Entra ID e pode, opcionalmente, incluir registos eliminados. Exporta os resultados para ficheiros CSV e um livro do Excel (xlsx) e pode enviá-los por e-mail. Os ficheiros do relatório também podem ser carregados para um Azure Storage Account, devolvendo links de download com limite de tempo. O parâmetro ReportFileFormat controla que formatos de ficheiro são gerados e entregues (apenas CSV, CSV & XLSX, ou apenas XLSX). Quando os anexos CSV excedem o limite de tamanho do e-mail e "CSV & XLSX" está selecionado, o e-mail recorre apenas ao livro do Excel. Utilize-o para fins de inventário periódico, revisão e auditoria.

### Configuração relativa ao envio de e-mails

O envio de um relatório por e-mail é opcional e só acontece quando é fornecido um destinatário (`EmailTo`). O endereço do remetente é obtido da definição `RJReport.EmailSender` Tenant.

Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails através da API Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Consulte a [documentação das definições do relatório RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis.

#### Branding do e-mail

O e-mail do relatório respeita as definições Tenant opcionais `RJReport.Branding.*` :

* **Imagem de cabeçalho e rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação do rodapé** – destino da imagem do rodapé
* **Cor de destaque e cor 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 do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório – é usado em vez disso o padrão correspondente.

Instruções de configuração e requisitos da imagem: [Branding do e-mail](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Localização

Organização → Aplicações → Registo da Aplicação do Relatório

**Nome completo do Runbook**

rjgit-org\_applications\_report-application-registration

### Detalhes

| Propriedade         | Valor                                                                                                             |
| ------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Versão              | 1.3.0                                                                                                             |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)<br>Az.Accounts (>= 5.5.2)</p> |
| Agendável           | não                                                                                                               |

### Permissões

#### Permissões da aplicação

* **Tipo**: Microsoft Graph
  * Application.Read.All
    * *Lista todos os registos de aplicações e os respetivos Service Principals para o relatório*
  * Directory.Read.All
    * *Lê os registos de aplicações eliminados através de /directory/deletedItems quando IncludeDeletedApps está definido*
  * 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*
  * Organization.Read.All
    * *Lê /organization para obter o nome do Tenant no cabeçalho do relatório e no rodapé do e-mail*

### Parâmetros

#### 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                           | Cadeia de caracteres                  |
| Nome de apresentação do portal | Endereço(s) de e-mail do destinatário |

#### EmailFrom

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

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| 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 definição Tenant RJReport.Branding.HeaderImageUrl. Quando vazia, é usada a imagem de cabeçalho predefinida do RealmJoin.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| 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 definição Tenant RJReport.Branding.FooterImageUrl. Quando vazia, é usada a imagem de rodapé predefinida do RealmJoin.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### BrandingFooterLink

URL opcional para a qual a imagem do rodapé aponta. Obtida da definição Tenant RJReport.Branding.FooterLink. Quando vazia, é usada a ligação predefinida (<https://www.realmjoin.com>).

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### BrandingAccentColor

Substituição opcional da cor de destaque (hexadecimal de 6 dígitos, por exemplo '#0052cc') para o modelo do e-mail do relatório. Obtida da definição Tenant RJReport.Branding.AccentColor. Quando vazia ou inválida, é usada a cor de destaque predefinida do RealmJoin.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### BrandingTextColor

Substituição opcional da cor do texto (hexadecimal de 6 dígitos) para o modelo do e-mail do relatório. Obtida da definição Tenant RJReport.Branding.TextColor. Quando vazia ou inválida, é usada a cor do texto predefinida do RealmJoin.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### IncludeDeletedApps

Se deve incluir registos de aplicações eliminados no relatório (predefinição: verdadeiro)

| Propriedade                    | Valor                         |
| ------------------------------ | ----------------------------- |
| Obrigatório                    | Falso                         |
| Valor predefinido              | Verdadeiro                    |
| Tipo                           | Booleano                      |
| Nome de apresentação do portal | Incluir aplicações eliminadas |

#### ReportFileFormat

Controla que formatos de ficheiro do relatório são gerados e entregues: "apenas CSV", "CSV & XLSX" (predefinição) ou "apenas XLSX".

| Propriedade                    | Valor                            |
| ------------------------------ | -------------------------------- |
| Obrigatório                    | Falso                            |
| Valor predefinido              | CSV & XLSX                       |
| Tipo                           | Cadeia de caracteres             |
| Nome de apresentação do portal | Formato do ficheiro do relatório |

**Opções do portal**

| Opção do portal | Valor |
| --------------- | ----- |
| CSV & XLSX      |       |
| Apenas CSV      |       |
| Apenas XLSX     |       |

#### CreateDownloadLink

Se ativado, os ficheiros do relatório são carregados para um Azure Storage Account e são devolvidos links de download com limite de tempo. Desativado por predefinição.

| Propriedade                    | Valor                                                                                  |
| ------------------------------ | -------------------------------------------------------------------------------------- |
| Obrigatório                    | Falso                                                                                  |
| Valor predefinido              | Falso                                                                                  |
| Tipo                           | Booleano                                                                               |
| Nome de apresentação do portal | Criar uma ligação de download do ficheiro (carregar o relatório para o armazenamento)? |

**Opções do portal**

| Opção do portal                                               | Valor |
| ------------------------------------------------------------- | ----- |
| Sim - carregar o relatório e devolver uma ligação de download | true  |
| 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 definição global do RJReport).

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido | report-application-registration                        |
| Tipo              | Cadeia de caracteres                                   |
| 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 Tenant RJReport.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | Falso                                                  |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| 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 Tenant RJReport.

| 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 até o link de download gerado expirar. Obtido das definições Tenant RJReport.

| 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/automacao/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/org/applications/report-application-registration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.