> 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/general/report-license-assignment_scheduled.md).

# Relatório de atribuição de licenças agendado

Alertar quando a disponibilidade de licenças ultrapassar limites

{% hint style="info" %}
Este é um runbook agendado. Foi concebido para ser executado num agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](https://docs.realmjoin.com/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar agendamentos de runbook.
{% endhint %}

### Descrição

Verifica quantas licenças dos SKUs configurados ainda estão disponíveis. Quando uma contagem cai abaixo de um limite mínimo ou sobe acima de um limite máximo, os SKUs afetados são reportados para que você possa comprar ou recuperar licenças a tempo. O relatório pode ser enviado por e-mail ou disponibilizado como um link de download.

### Configuração de licenças

Os SKUs a verificar e os respetivos limites estão predefinidos na personalização do runbook como o `InputJson` valor oculto. Cada configuração de licença requer:

* **SKUPartNumber** (obrigatório): identificador de SKU da Microsoft
* **FriendlyName** (obrigatório): nome a apresentar
* **MinThreshold** (opcional): alerta quando as licenças disponíveis < limite
* **MaxThreshold** (opcional): alerta quando as licenças disponíveis > limite

Pelo menos um limite deve ser definido por licença.

#### Exemplos de configuração

**Apenas limite mínimo** (evitar escassez):

```json
[
    {
        "SKUPartNumber": "ENTERPRISEPACK",
        "FriendlyName": "Microsoft 365 E3",
        "MinThreshold": 50
    }
]
```

**Apenas limite máximo** (evitar sobreprovisionamento):

```json
[
    {
        "SKUPartNumber": "POWER_BI_PRO",
        "FriendlyName": "Power BI Pro",
        "MaxThreshold": 500
    }
]
```

**Ambos os limites** (manter a gama):

```json
[
    {
        "SKUPartNumber": "ENTERPRISEPREMIUM",
        "FriendlyName": "Microsoft 365 E5",
        "MinThreshold": 50,
        "MaxThreshold": 150
    }
]
```

#### Personalização completa do runbook

```json
{
    "Settings": {
        "RJReport": {
            "EmailSender": "sender@contoso.com"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "InputJson": {
                    "Hide": true,
                    "DefaultValue": [
                        {
                            "SKUPartNumber": "SPE_E5",
                            "FriendlyName": "Microsoft 365 E5",
                            "MinThreshold": 20,
                            "MaxThreshold": 30
                        },
                        {
                            "SKUPartNumber": "FLOW_FREE",
                            "FriendlyName": "Microsoft Power Automate Free",
                            "MinThreshold": 10
                        }
                    ]
                }
            }
        }
    }
}
```

Consulte a [Guia de Personalização de Runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization) para a sintaxe.

### Encontrar números de parte de SKU

```powershell
Connect-MgGraph -Scopes "Organization.Read.All"
Get-MgSubscribedSku | Select-Object SkuPartNumber, SkuId | Sort-Object SkuPartNumber
```

SKUs comuns:

* `ENTERPRISEPACK` - Microsoft 365 E3
* `ENTERPRISEPREMIUM` - Microsoft 365 E5
* `EMS` - Enterprise Mobility + Security E3

### Resultados

Cada execução escreve os seus resultados no separador Output Data do portal RealmJoin: um resumo, as licenças fora dos seus limites, os SKUs configurados que não existem no Tenant e as licenças dentro dos seus limites. Cada tabela pode ser exportada para Excel aí.

* **Quando são detetadas violações:** os ficheiros de relatório (CSV e/ou livro do Excel) listam as licenças fora dos seus limites, e o e-mail contém o resumo, as violações, as recomendações e os ficheiros como anexos.
* **Quando um SKU configurado não é encontrado:** o e-mail lista o SKU como um problema de configuração.
* **Quando todas as licenças estão dentro dos seus limites:** não é enviado nenhum e-mail, não é criado nenhum ficheiro de relatório e a execução termina com êxito.

### Entrega do relatório

Os ficheiros de relatório só são gerados quando é selecionado um método de entrega através da **Entrega do relatório** opção (e-mail e/ou link de download) e pelo menos uma licença está fora dos seus limites. Com *Apenas Output Data* selecionado, os resultados são lidos diretamente no separador Output Data do portal RealmJoin, onde cada tabela também pode ser exportada para Excel. A entrega por e-mail e a geração de link de download são independentes e podem ser combinadas.

Para o link de download, os ficheiros de relatório são carregados para a Storage Account do Azure configurada nas `RJReport.StorageAccount.*` configurações do Tenant, e são devolvidos links de download SAS com prazo limitado. O carregamento para o armazenamento autentica-se com a identidade gerida da Automation account; essa identidade precisa da **Reader and Data Access** função RBAC na Storage Account de destino (esta é 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 e-mail: um destinatário armazenado por si só ainda ativa o e-mail para eles. Quando esse agendamento é aberto para edição, a opção apresenta *Apenas Output Data*; selecione novamente a entrega antes de guardar, caso contrário o agendamento deixa de enviar o relatório.

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

O envio de um relatório por e-mail é opcional e só acontece quando *Enviar também o relatório por e-mail* ou *Enviar também por e-mail e link de download* é selecionado como entrega do relatório; nesse caso, é necessário um destinatário. O endereço do remetente é obtido da `RJReport.EmailSender` definição do Tenant.

Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails via a API Graph, é necessário configurar um endereço de e-mail 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 e-mail

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

* **Imagem de cabeçalho e rodapé** - URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Link 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 descarregada ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório - em vez disso, é usado o predefinido correspondente.

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

### Resolução de problemas

**SKU não encontrado**: Verifique se o SKU existe usando `Get-MgSubscribedSku`.

**E-mail não enviado**: Verifique a `RJReport.EmailSender` definição e a permissão Mail.Send da identidade gerida. Não é enviado nenhum e-mail quando todas as licenças estão dentro dos seus limites.

**JSON inválido**: Valide o formato JSON antes de o configurar.

### Nota de migração

Legado `WarningThreshold` mapeia automaticamente para `MinThreshold` - as configurações antigas continuam a funcionar.

### Localização

Organization → Geral → Atribuição de licenças do relatório (agendado)

**Nome completo do runbook**

rjgit-org\_general\_report-license-assignment\_scheduled

### Detalhes

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

### Permissões

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

* **Tipo**: Microsoft Graph
  * Organization.Read.All
    * *Lê /organization e /subscribedSkus para avaliar as contagens de licenças face aos limites*
  * Mail.Send *(opcional — funcionalidade: relatório por e-mail)*
    * *Envia o e-mail do relatório de limites através de Send-RjRbReportEmail quando a entrega por e-mail é selecionada*

#### Notas de permissão

Azure Storage Account: função 'Reader and Data Access' para a identidade gerida da Automation Account na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (apenas necessário para as opções de link de download)

### Parâmetros

#### InputJson

Lista de SKUs com nomes amigáveis e limites mínimos e máximos, como um array JSON. Predefinida na personalização do runbook.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | true                                            |
| Valor predefinido |                                                 |
| Tipo              | Objeto                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### ReportFileFormat

Entregue o relatório como CSV, como um livro do Excel ou ambos.

| Propriedade                | Valor                                           |
| -------------------------- | ----------------------------------------------- |
| Obrigatório                | false                                           |
| Valor predefinido          | CSV & XLSX                                      |
| Tipo                       | String                                          |
| Nome de exibição no portal | Formato do ficheiro de relatório                |
| Oculto no portal           | sim (predefinido via personalização do runbook) |

**Opções do portal**

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

#### CreateDownloadLink

Carregue também o relatório e devolva um link de download que expira após alguns dias.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | Falso                                           |
| Tipo              | Boolean                                         |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### ContainerName

Contentor de armazenamento para o qual os ficheiros de relatório são carregados. Definido por runbook.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | report-license-assignment                       |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da Storage Account para carregamentos de relatórios. Obtido da definição do Tenant RJReport.StorageAccount.ResourceGroup.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### StorageAccountName

Storage Account para carregamentos de relatórios. Obtido da definição do Tenant RJReport.StorageAccount.StorageAccountName.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### SubscriptionId

ID da subscrição da Storage Account para carregamentos de relatórios. Obtido da definição do Tenant RJReport.StorageAccount.SubscriptionId; quando vazio, é usada a subscrição na qual a identidade gerida inicia sessão.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### LinkExpiryDays

Número de dias durante os quais um link de download permanece válido. Obtido da definição do Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | 6                                               |
| Tipo              | Int32                                           |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### SendEmailReport

Envie o relatório para o endereço de e-mail do destinatário.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | Falso                                           |
| Tipo              | Boolean                                         |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### EmailTo

Envie o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um e-mail separado.

| Propriedade                | Valor                                           |
| -------------------------- | ----------------------------------------------- |
| Obrigatório                | false                                           |
| Valor predefinido          |                                                 |
| Tipo                       | String                                          |
| Nome de exibição no portal | Endereço(s) de e-mail do destinatário           |
| Oculto no portal           | sim (predefinido via personalização do runbook) |

#### EmailFrom

Endereço do remetente do e-mail do relatório. Obtido da definição do Tenant RJReport.EmailSender.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingHeaderImageUrl

Imagem de cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; quando vazio, é usado o cabeçalho predefinido do RealmJoin.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingFooterImageUrl

Imagem de rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; quando vazio, é usado o rodapé predefinido do RealmJoin.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingFooterLink

Link por trás da imagem de rodapé do e-mail do relatório. Obtido da definição do Tenant RJReport.Branding.FooterLink; quando vazio, é usado realmjoin.com.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingAccentColor

Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; quando vazio ou inválido, é usado o valor predefinido do RealmJoin.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingTextColor

Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; quando vazio ou inválido, é usado o valor predefinido do RealmJoin.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/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/general/report-license-assignment_scheduled.md?ask=<question>&goal=<user_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.
