> 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, quantas estão em uso e 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 único ZIP, com links de download. Nada é alterado, a menos que sejam solicitados dados reais de utilizadores, o que desativa brevemente a definição de privacidade do relatório e depois a restaura.
### Configure a Storage Account para a exportação
Os ficheiros do relatório são carregados para uma Storage Account do Azure. A sua subscrição, grupo de recursos e nome provêm das definições de Tenant abaixo; o nome do contentor é obtido de `OfficeLicensingReport.Container`. Os parâmetros deste runbook são suportados por `OfficeLicensingReport.*` definições também, pelo que os seus valores predefinidos podem ser definidos por Tenant.
```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.1.3 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Az.Accounts (>= 5.5.2)
ExchangeOnlineManagement (>= 3.9.2)
|
| Agendável | não |
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* Reports.Read.All
* *Obtém os CSVs dos relatórios de utilização e atividade do Office 365 de /reports*
* Directory.Read.All
* *Lê /subscribedSkus e as atribuições de licenças de grupos para a visão geral dos SKUs*
* User.Read.All
* *Lista os utilizadores e lê os respetivos detalhes de licença para os relatórios por utilizador*
* ReportSettings.ReadWrite.All
* *Desativa temporariamente os nomes ocultos dos relatórios quando includeUserData está ativado e, em seguida, restaura a definição*
* AuditLog.Read.All *(opcional — funcionalidade: exportação de início de sessão)*
* *Lê /auditLogs/signIns para a exportação de inícios de sessão por aplicação quando exportToFile está ativado (por predefinição)*
* **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*
#### funções RBAC
* Administrador do Exchange
* *Necessário para a sessão do Exchange Online apenas para a aplicação quando includeExchange está ativado*
### Parâmetros
#### printOverview
Imprime uma tabela por SKU de licença com contagens totais, usadas, disponíveis e suspensas na saída da execução.
| Propriedade | Valor |
| ----------------- | ---------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
#### includeExchange
Adiciona relatórios do Exchange Online, como o licenciamento de caixas de correio partilhadas.
| Propriedade | Valor |
| ----------------- | -------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
#### includeUserData
Mostra os nomes reais dos utilizadores nos relatórios de atividade, desativando a definição de privacidade do relatório durante a execução; 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 predefinido | Falso |
| Tipo | Booleano |
#### exportToFile
Carrega os ficheiros do relatório para a Storage Account do Azure configurada nas definições de Tenant.
| Propriedade | Valor |
| ----------------- | ---------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
#### exportAsZip
Carrega um ficheiro ZIP em vez dos ficheiros individuais do relatório.
| Propriedade | Valor |
| ----------------- | -------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
#### gerarLinks
Devolve links de download temporários para os ficheiros carregados.
| Propriedade | Valor |
| ----------------- | ---------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
#### ContainerName
Contentor de armazenamento para onde os ficheiros do relatório são carregados. Obtido da definição de Tenant OfficeLicensingReport.Container.
| Propriedade | Valor |
| ----------------- | ------------------------ |
| Obrigatório | falso |
| Valor predefinido | rjrb-licensing-report-v2 |
| Tipo | Cadeia de caracteres |
#### ResourceGroupName
Grupo de recursos da Storage Account. Obtido da definição de Tenant OfficeLicensingReport.ResourceGroup.
| Propriedade | Valor |
| ----------------- | -------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
#### StorageAccountName
Storage Account para a exportação. Obtida da definição de Tenant OfficeLicensingReport.StorageAccount.Name.
| Propriedade | Valor |
| ----------------- | -------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
#### SubscriptionId
Subscrição do Azure que contém a Storage Account. Obtida da definição de Tenant OfficeLicensingReport.SubscriptionId.
| Propriedade | Valor |
| ----------------- | -------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
[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/general/office365-license-report.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.