> 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

Reportar inscrições recentes pela primeira vez de dispositivos Windows Autopilot

{% 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. Consulte [Agendamento](https://docs.realmjoin.com/pt/automatizacao/runbooks/scheduling.md) para ver detalhes sobre como configurar agendamentos de runbook.
{% endhint %}

### Descrição

Lista dispositivos Windows registados no Autopilot que foram inscritos pela primeira vez no número de semanas escolhido. São agrupados por um atributo à sua escolha, como país ou departamento, para que possa ver onde surgem novos dispositivos. Dispositivos iOS, Android e macOS e dispositivos Windows inscritos sem Autopilot não estão incluídos. O relatório pode ser exportado como CSV para uma Azure Storage Account e descarregado a partir daí.

### Que dispositivos estão incluídos

O relatório parte das identidades de dispositivos Windows Autopilot no Intune, pelo que lista apenas dispositivos Windows registados no Autopilot. Dispositivos iOS, Android e macOS e dispositivos Windows inscritos sem Autopilot não estão incluídos, mesmo quando foram inscritos dentro do intervalo de tempo.

* **Data de atribuição do perfil do Autopilot** conta um dispositivo a partir do dia em que o respetivo perfil do Autopilot foi atribuído.
* **Data de inscrição no Intune** conta um dispositivo a partir do dia em que se inscreveu no Intune. Um dispositivo Autopilot sem um objeto do Intune não é listado.

### Atributo pelo qual agrupar

O atributo é uma propriedade do objeto escolhido em **Agrupar dados a partir de**, por exemplo `país` ou `departamento` do utilizador do Entra ID, `fabricante` do dispositivo Intune ou `groupTag` do dispositivo Autopilot. Não pode estar vazio, e `apDevice`, `intuneDevice`, `APAssignmentDate` e `IntuneEnrolledDate` são nomes usados pelo próprio relatório. Com um destes valores, a execução é interrompida com um erro antes de ler quaisquer dados.

### Pesquisas falhadas

Para cada dispositivo, o runbook lê o dispositivo Intune e, consoante o agrupamento, o utilizador ou dispositivo do Entra ID. Um dispositivo ou utilizador que não exista conta como não inscrito ou deixa o atributo vazio. Qualquer outro erro, como uma permissão Graph em falta (403 Forbidden) ou um erro de serviço, é contabilizado: o relatório continua a ser criado, carregado e apresentado como Output Data, mas pode ficar sem dispositivos ou com colunas vazias, pelo que a execução termina então como falhada com o número de pesquisas falhadas e o primeiro erro.

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

A exportação CSV carrega o relatório para uma Storage Account Azure existente e devolve uma ligação de descarregamento. O runbook cria o contentor quando este está em falta, mas não a Storage Account. A identidade gerida da Automation Account precisa da `, atribuída diretamente na Storage Account.` função na Storage Account.

Configure a Storage Account nas definições do Tenant em `RJReport.StorageAccount`, as mesmas definições que todos os runbooks de relatórios usam (ver [Definições de relatório do runbook](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings)). `LinkExpiryDays` define quantos dias a ligação de descarregamento permanece válida; sem isso, a ligação expira após 6 dias. `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)).

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

As definições específicas do runbook `EnrolledDevicesReport.ResourceGroup` e `EnrolledDevicesReport.StorageAccount.Name` continuam a ser lidas e têm precedência sobre `RJReport.StorageAccount`. `EnrolledDevicesReport.StorageAccount.Location` e `EnrolledDevicesReport.StorageAccount.Sku` já não são necessárias e são ignoradas. O nome do contentor é obtido de `EnrolledDevicesReport.Container`; sem ele, o runbook usa `enrolled-devices-<weeks>w-<date>`.

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.1.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 de aplicativo

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

#### Notas de permissão

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

### Parâmetros

#### Semanas

Quantas semanas recuar para procurar as primeiras inscrições.

| Propriedade  | Valor |
| ------------ | ----- |
| Obrigatório  | falso |
| Valor padrão | 4     |
| Tipo         | Int32 |

#### dataSource

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

| Propriedade  | Valor |
| ------------ | ----- |
| Obrigatório  | falso |
| Valor padrão | 0     |
| Tipo         | Int32 |

#### groupingSource

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

| Propriedade  | Valor |
| ------------ | ----- |
| Obrigatório  | falso |
| Valor padrão | 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 padrão | país  |
| Tipo         | Texto |

#### exportCsv

Carrega o relatório como CSV para a Storage Account e devolve uma ligação de descarregamento. Necessita de uma Storage Account configurada.

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

#### ContainerName

Contentor de armazenamento para o qual o relatório é carregado. Obtido a partir da definição do Tenant EnrolledDevicesReport.Container; caso contrário, definido por runbook.

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

#### ResourceGroupName

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

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

#### StorageAccountName

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

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

#### SubscriptionId

ID da subscrição do Storage Account indicado em ResourceGroupName e StorageAccountName. Não é obtido de uma definição do Tenant; quando estiver vazio, é usada a subscrição na qual a identidade gerida inicia sessão.

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

#### StorageAccountLocation

Já não é usado, porque a Storage Account já não é criada. Mantido para que os agendamentos e chamadas de API existentes continuem a iniciar; um valor passado apenas adiciona um aviso de descontinuação à execução.

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

#### StorageAccountSku

Já não é usado, porque a Storage Account já não é criada. Mantido para que os agendamentos e chamadas de API existentes continuem a iniciar; um valor passado apenas adiciona um aviso de descontinuação à execução.

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

#### RJReportResourceGroupName

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

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

#### RJReportStorageAccountName

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

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

#### 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 |

#### 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 |

[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/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.
