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

# Relatório de licenças do Microsoft 365

Reportar a utilização e disponibilidade de licenças do Microsoft 365

### Descrição

Cria um relatório das licenças do Microsoft 365 no Tenant, de quantas estão em uso e de quantas estão livres. Podem ser adicionados detalhes do Exchange Online, como o licenciamento de caixas de correio partilhadas. Os ficheiros do relatório podem ser carregados para uma Storage Account do Azure, como ficheiros individuais ou como um ZIP, com links de download. Nada é alterado, a menos que sejam solicitados dados reais do utilizador, o que desativa brevemente a definição de privacidade do relatório e a restaura depois.

### Configure a Storage Account para a exportação

Os ficheiros do relatório são carregados para uma Storage Account do Azure existente; ela não é criada automaticamente. A configuração recomendada é a partilhada `RJReport.StorageAccount` definição que os outros runbooks de relatório também usam (ver [Definições de relatório do runbook](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings)). `LinkExpiryDays` define quantos dias os links de download permanecem válidos (predefinição 6). `SubscriptionId` é opcional, mas recomendado: garante que o carregamento usa a subscrição que contém a Storage Account (ver [Assinatura da Storage Account](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#subscription-of-the-storage-account)). O nome do contentor é obtido de `OfficeLicensingReport.Container`. As opções deste runbook também são suportadas por `OfficeLicensingReport.*` definições, para que os seus valores predefinidos possam ser fixados por Tenant.

```json
{
	"Settings": {
		"RJReport": {
			"StorageAccount": {
				"ResourceGroup": "rj-test-runbooks-01",
				"StorageAccountName": "rbexports01",
				"SubscriptionId": "00000000-0000-0000-0000-000000000000",
				"LinkExpiryDays": 6
			}
		}
	}
}
```

A identidade gerida da Automation Account precisa da `, atribuída diretamente na Storage Account.` função na Storage Account.

As definições específicas do runbook abaixo ainda são lidas. Quando o respetivo grupo de recursos e o nome da Storage Account estão definidos, têm precedência sobre `RJReport.StorageAccount`; `SubscriptionId` só é usado em conjunto com eles.

```json
{
	"Settings": {
		"OfficeLicensingReport": {
			"ResourceGroup": "rj-test-runbooks-01",
			"SubscriptionId": "00000000-0000-0000-0000-000000000000",
			"StorageAccount": {
				"Name": "rbexports01"
			}
		}
	}
}
```

Para mais informações sobre como personalizar runbooks, consulte o [Guia de Personalização de Runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Localização

Organização → Geral → Relatório de Licenças do Office365

**Nome completo do runbook**

rjgit-org\_general\_office365-license-report

### Detalhes

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

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * Directory.Read.All
    * *Lê /subscribedSkus e as atribuições de licenças de grupos para a visão geral do SKU*
  * Reports.Read.All
    * *Obtém os CSVs dos relatórios de utilização e atividade do Office 365 a partir de /reports*
  * ReportSettings.ReadWrite.All
    * *Desativa temporariamente os nomes ocultos dos relatórios quando includeUserData está ativado e depois restaura a definição*
  * User.Read.All
    * *Lista os utilizadores e lê os respetivos detalhes de licença para os relatórios por utilizador*
  * AuditLog.Read.All *(opcional — funcionalidade: exportação de início de sessão)*
    * *Lê /auditLogs/signIns para a exportação de início de sessão por aplicação quando exportToFile está ativado (predefinição ativada)*
* **Tipo**Office 365 Exchange Online
  * Exchange.ManageAsApp *(opcional — funcionalidade: relatório de licenciamento do Exchange)*
    * *Executa Get-EXOMailbox para o relatório de licenciamento de caixas de correio partilhadas quando includeExchange está ativado*

#### 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 (só é necessário quando exportToFile está ativado)

#### Funções RBAC

* Administrador do Exchange
  * *Necessário para a sessão do Exchange Online apenas para aplicação quando includeExchange está ativado*

### Parâmetros

#### printOverview

Imprime uma tabela por SKU de licença com contagens totais, utilizadas, disponíveis e suspensas na saída da execução.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | falso      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### includeExchange

Adiciona relatórios do Exchange Online, como o licenciamento de caixas de correio partilhadas.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### includeUserData

Mostra nomes reais de utilizadores nos relatórios de atividade ao desativar, para a execução, a definição de privacidade dos relatórios; depois é restaurada. Os relatórios passam então a conter dados pessoais, por isso verifique primeiro as suas regras de proteção de dados.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### exportToFile

Carrega os ficheiros do relatório para a Storage Account do Azure configurada nas definições do Tenant.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | falso      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### exportAsZip

Carrega um único ficheiro ZIP em vez dos ficheiros individuais do relatório.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### produceLinks

Devolve links de download com prazo limitado para os ficheiros carregados.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | falso      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### ContainerName

Contentor de armazenamento para o qual os ficheiros do relatório são carregados. Obtido da definição do Tenant OfficeLicensingReport.Container.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | rjrb-licensing-report-v2                                |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da Storage Account para carregamentos de relatórios. Obtido da definição do Tenant OfficeLicensingReport.ResourceGroup; quando não está definida, é usado RJReport.StorageAccount.ResourceGroup.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### StorageAccountName

Storage Account para carregamentos de relatórios. Obtida da definição do Tenant OfficeLicensingReport.StorageAccount.Name; quando não está definida, é usada RJReport.StorageAccount.StorageAccountName.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### SubscriptionId

ID da subscrição da Storage Account para carregamentos de relatórios. Obtido da definição do Tenant OfficeLicensingReport.SubscriptionId e usado apenas com OfficeLicensingReport.\*; vazio significa a subscrição na qual a identidade gerida inicia sessão.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### RJReportResourceGroupName

Grupo de recursos da Storage Account para carregamentos de relatórios. Obtido da definição do Tenant RJReport.StorageAccount.ResourceGroup e usado quando OfficeLicensingReport.ResourceGroup não está definido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### RJReportStorageAccountName

Storage Account para carregamentos de relatórios. Obtida da definição do Tenant RJReport.StorageAccount.StorageAccountName e usada quando OfficeLicensingReport.StorageAccount.Name não está definida.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### RJReportSubscriptionId

ID da subscrição da Storage Account para carregamentos de relatórios. Obtido da definição do Tenant RJReport.StorageAccount.SubscriptionId e usado quando a Storage Account provém de RJReport.StorageAccount.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### LinkExpiryDays

Número de dias que um link de download permanece válido. Obtido da configuração do Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | 6                                                       |
| Tipo             | Int32                                                   |
| Oculto no portal | sim (predefinido por meio da 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/office365-license-report.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.
