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

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

### Descrição

Este runbook verifica a disponibilidade de licenças com base nos SKUs transmitidos e envia um relatório por email se algum limite for atingido. Podem ser configurados dois tipos de limites. O primeiro tipo é um limite mínimo, que desencadeia um alerta quando o número de licenças disponíveis fica abaixo de um número especificado. O segundo tipo é um limite máximo, que desencadeia um alerta quando o número de licenças disponíveis excede um número especificado. O relatório inclui informações detalhadas sobre as licenças que estão fora dos limites configurados, exporta-as para ficheiros CSV e envia-as por email.

### Personalização do runbook

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

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

Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails por meio da API Microsoft Graph, você precisa 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](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para mais detalhes.

#### Configuração de InputJson

Cada configuração de licença requer:

* **SKUPartNumber** (obrigatório): Identificador do 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 faltas):

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

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

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

**Ambos os limites** (manter intervalo):

```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": {
                "EmailTo": {
                    "DisplayName": "Endereços de email dos destinatários"
                },
                "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
                        }
                    ]
                },
                "EmailFrom": {
                    "Hide": true
                },
                "CallerName": {
                    "Hide": true
                }
            }
        }
    }
}
```

### Encontrar números de peça do 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

### Saída

**Quando forem detetadas violações:**

* Saída de consola no registo do trabalho
* Exportação CSV (`License_Threshold_Violations.csv`)
* Relatório por email com resumo, violações, recomendações e anexo CSV

**Quando tudo estiver dentro dos limites:**

* Nenhum email enviado
* O trabalho conclui com êxito

### Resolução de problemas

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

**Email não enviado**: Verifique a configuração de EmailFrom e a permissão Mail.Send

**JSON inválido**: Valide o formato JSON antes da configuração

### Nota de migração

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

### Localização

Organização → Geral → Relatório de atribuição de licenças (agendado)

**Nome completo do runbook**

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

### Permissões

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

* **Tipo**: Microsoft Graph
  * Organization.Read.All
  * User.Read.All
  * Mail.Send

### Parâmetros

#### InputJson

Matriz JSON contendo configurações de SKU com limites. Cada entrada deve incluir um SKUPartNumber para o identificador do SKU da Microsoft, um FriendlyName como nome a apresentar para a licença, um MinThreshold opcional que especifica o número mínimo de licenças que deve estar disponível e um MaxThreshold opcional que especifica o número máximo de licenças que deve estar disponível.

Isto precisa de ser configurado na personalização do runbook

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | true   |
| Valor predefinido |        |
| Tipo              | Objeto |

#### EmailTo

Endereço de email do destinatário ou lista de destinatários separada por vírgulas.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | true   |
| Valor predefinido |        |
| Tipo              | String |

#### EmailFrom

Endereço de email do remetente resolvido a partir das definições.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

[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:

```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/org/general/report-license-assignment_scheduled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.