> 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/devices/cleanup-autopilot-devices_scheduled.md).

# Limpeza agendada de dispositivos Autopilot

### Descrição

Este runbook agendado executa manutenção regular dos registos de dispositivos Windows Autopilot, identificando e removendo dispositivos órfãos cujos números de série já não correspondem a qualquer dispositivo gerido pelo Intune, e removendo opcionalmente dispositivos Autopilot nunca inscritos que excedam um limite de idade configurável. O runbook opera, por predefinição, no modo WhatIf para um relatório seguro e pode, opcionalmente, enviar um resumo por e-mail com anexos CSV e/ou Excel (xlsx) listando os dispositivos que seriam ou foram eliminados. Os ficheiros de relatório também podem ser carregados para uma Azure Storage Account, devolvendo links de transferência com prazo limitado. O parâmetro ReportFileFormat controla quais formatos de ficheiro são gerados e entregues (apenas CSV, CSV e XLSX, ou apenas XLSX). Quando o anexo CSV excede o limite de tamanho do e-mail e "CSV & XLSX" é selecionado, o e-mail recorre apenas ao livro de trabalho do Excel.

### Configuração relativa ao envio de e-mail

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 da `RJReport.EmailSender` configuração do Tenant.

Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails através da API do Microsoft Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Consulte a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para mais detalhes.

### Localização

Organização → Dispositivos → Limpeza de Dispositivos Autopilot (Agendado)

**Nome completo do runbook**

rjgit-org\_devices\_cleanup-autopilot-devices\_scheduled

### Permissões

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

* **Tipo**: Microsoft Graph
  * Device.ReadWrite.All
  * DeviceManagementManagedDevices.Read.All
  * DeviceManagementServiceConfig.ReadWrite.All
  * Mail.Send
  * Organization.Read.All

### Parâmetros

#### Modo de eliminação

Controla o que o runbook faz com os candidatos à limpeza identificados. "WhatIf (apenas relatório)" não efetua qualquer eliminação e apenas apresenta os candidatos (predefinição, seguro). "Eliminar dispositivo Autopilot" remove as identidades dos dispositivos Autopilot. "Eliminar dispositivo Autopilot e Entra" remove as identidades Autopilot e os objetos de dispositivo correspondentes do Entra (Azure AD), que, de outro modo, permaneceriam como registos obsoletos.

| Propriedade       | Valor                     |
| ----------------- | ------------------------- |
| Obrigatório       | false                     |
| Valor predefinido | WhatIf (apenas relatório) |
| Tipo              | String                    |

#### Filtro de tag de grupo

Tags de grupo Autopilot separadas por vírgulas para limitar o âmbito da limpeza. Correspondência exata (não sensível a maiúsculas/minúsculas). Deixe em branco para processar todos os dispositivos Autopilot, independentemente da tag de grupo.

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

#### Filtro de fabricante

Fabricantes de dispositivos separados por vírgulas para limitar o âmbito da limpeza. Correspondência como substrings não sensível a maiúsculas/minúsculas, por isso "Dell" corresponde a "Dell Inc.". Combinado com os outros filtros usando AND. Deixe em branco para processar todos os fabricantes.

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

#### Filtro de modelo

Modelos de dispositivos separados por vírgulas para limitar o âmbito da limpeza. Correspondência como substrings não sensível a maiúsculas/minúsculas, por isso "Surface" corresponde a "Surface Laptop 3". Combinado com os outros filtros usando AND. Deixe em branco para processar todos os modelos.

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

#### Excluir números de série

Números de série separados por vírgulas a excluir da limpeza. Correspondência exata (não sensível a maiúsculas/minúsculas). Qualquer dispositivo cujo número de série esteja nesta lista é removido do âmbito, independentemente dos outros filtros. Deixe em branco para não excluir nada.

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

#### Limpar dispositivos órfãos

Quando ativado, remove dispositivos Autopilot que contactaram o Intune no passado, mas cujo número de série já não é encontrado entre os dispositivos geridos pelo Intune (o registo do dispositivo gerido foi eliminado).

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

#### Limite de idade em dias para dispositivos órfãos

Limite de idade em dias para dispositivos órfãos. Um dispositivo Autopilot só é tratado como órfão quando o seu último contacto com o Intune ocorreu há mais do que este número de dias e o seu número de série já não está presente no Intune. Isto impede a remoção de dispositivos que contactaram o Intune recentemente.

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | false |
| Valor predefinido | 90    |
| Tipo              | Int32 |

#### Limpar dispositivos nunca inscritos

Quando ativado, remove dispositivos Autopilot nunca inscritos (dispositivos que nunca contactaram o Intune).

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | false    |
| Valor predefinido | Falso    |
| Tipo              | Booleano |

#### Limite de idade em dias para dispositivos nunca inscritos

Limite de idade em dias para dispositivos nunca inscritos. Medido na data de criação do dispositivo.

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | false |
| Valor predefinido | 90    |
| Tipo              | Int32 |

#### EmailTo

Endereço de e-mail opcional do destinatário para o relatório de resumo da limpeza. Deixe em branco para escrever os resultados apenas no registo do runbook.

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

#### EmailFrom

O endereço de e-mail do remetente para o relatório de resumo. Isto é configurado através de Personalizações do Runbook.

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

#### ReportFileFormat

Controla quais formatos de ficheiro do relatório são gerados e entregues: "apenas CSV", "CSV & XLSX" (predefinição) ou "apenas XLSX".

| Propriedade       | Valor      |
| ----------------- | ---------- |
| Obrigatório       | false      |
| Valor predefinido | CSV & XLSX |
| Tipo              | String     |

#### CreateDownloadLink

Se ativado, os ficheiros do relatório são carregados para um Azure Storage Account e são devolvidas ligações de download com validade limitada. Desativado por predefinição.

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | false    |
| Valor predefinido | Falso    |
| Tipo              | Booleano |

#### ContainerName

Nome do contentor de armazenamento usado para o carregamento. Configurado por runbook (não é uma definição global do RJReport).

| Propriedade       | Valor                     |
| ----------------- | ------------------------- |
| Obrigatório       | false                     |
| Valor predefinido | cleanup-autopilot-devices |
| Tipo              | String                    |

#### ResourceGroupName

Grupo de recursos que contém a Storage Account. Obtido das configurações do Tenant do RJReport.

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

#### StorageAccountName

Nome da Storage Account usado para o carregamento. Obtido das configurações do Tenant do RJReport.

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

#### LinkExpiryDays

Número de dias até que a ligação de download gerada expire. Obtido das configurações do Tenant do RJReport.

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | false |
| Valor predefinido | 6     |
| Tipo              | Int32 |

[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, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/org/devices/cleanup-autopilot-devices_scheduled.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.