> 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/enrolled-devices-report_scheduled.md).

# Relatório de dispositivos inscritos agendado

Relatar inscrições de dispositivos pela primeira vez das últimas semanas

{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}

### Descrição

Lista dispositivos que foram inscritos pela primeira vez dentro do número de semanas escolhido. Eles são agrupados por um atributo à sua escolha, como país ou departamento, para que você possa ver onde os novos dispositivos aparecem. O relatório pode ser exportado como CSV para uma Azure Storage Account e descarregado a partir daí.

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

A exportação CSV envia o relatório para uma Azure Storage Account. O seu grupo de recursos, nome, região e nível de desempenho vêm das definições do Tenant abaixo; o nome do contentor é obtido de `EnrolledDevicesReport.Container`.

```json
{
  "Settings": {
    "EnrolledDevicesReport": {
      "ResourceGroup": "rj-test-runbooks-01",
      "StorageAccount": {
        "Name": "rjrbexports01",
        "Location": "Europa Ocidental",
        "Sku": "Standard_LRS"
      }
    }
  }
}
```

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 Dispositivos Inscritos (Agendado)

**Nome completo do Runbook**

rjgit-org\_general\_enrolled-devices-report\_scheduled

### Detalhes

| Propriedade         | Valor                               |
| ------------------- | ----------------------------------- |
| Versão              | 1.0.1                               |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10) |
| Agendável           | sim                                 |

### Permissões

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

* **Tipo**: Microsoft Graph
  * DeviceManagementServiceConfig.Read.All
    * *Lista todos os dispositivos Autopilot como o conjunto de dados base do relatório*
  * DeviceManagementManagedDevices.Read.All
    * *Lê cada dispositivo Intune para obter a data de inscrição e as informações do utilizador*
  * User.Read.All
    * *Lê o atributo de agrupamento do utilizador de cada dispositivo ao agrupar por propriedades do utilizador*
  * Device.ReadWrite.All
    * *Lê objetos de dispositivo Entra ID para agrupamento por propriedades do dispositivo*

#### Notas de permissão

Azure: Colaborador no Storage Account

### Parâmetros

#### Semanas

Quantas semanas para trás procurar as primeiras inscrições.

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | falso |
| Valor predefinido | 4     |
| Tipo              | Int32 |

#### dataSource

A data de atribuição do perfil de Autopilot conta um dispositivo a partir do dia em que o seu perfil de Autopilot foi atribuído; a data de inscrição no Intune conta-o a partir do dia em que se inscreveu no Intune.

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | falso |
| Valor predefinido | 0     |
| Tipo              | Int32 |

#### groupingSource

De onde vem o atributo de agrupamento: sem agrupamento, propriedades de utilizador ou de dispositivo do Entra ID, propriedades de dispositivo do Intune ou propriedades de dispositivo do Autopilot.

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | falso |
| Valor predefinido | 1     |
| Tipo              | Int32 |

#### groupingAttribute

Nome do atributo pelo qual os dispositivos são agrupados, por exemplo país ou departamento.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido | país                 |
| Tipo              | Cadeia de caracteres |

#### exportCsv

Envia o relatório como CSV para a Storage Account e devolve um link de transferência. Necessita de uma Storage Account configurada.

| Propriedade       | Valor      |
| ----------------- | ---------- |
| Obrigatório       | falso      |
| Valor predefinido | Verdadeiro |
| Tipo              | Booleano   |

#### ContainerName

Contentor de armazenamento para onde o relatório é enviado. Obtido da definição do Tenant EnrolledDevicesReport.Container.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ResourceGroupName

Grupo de recursos da Storage Account. Obtido da definição do Tenant EnrolledDevicesReport.ResourceGroup.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### StorageAccountName

Storage Account para a exportação. Obtido da definição do Tenant EnrolledDevicesReport.StorageAccount.Name.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### StorageAccountLocation

Região do Azure usada quando a Storage Account tem de ser criada. Obtida da definição do Tenant EnrolledDevicesReport.StorageAccount.Location.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### StorageAccountSku

Nível de desempenho usado quando a Storage Account tem de ser criada. Obtido da definição do Tenant EnrolledDevicesReport.StorageAccount.Sku.

| 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/enrolled-devices-report_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.