> 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/dedup-device-names_scheduled.md).

# Eliminação de duplicados nos nomes dos dispositivos agendada

{% 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/automacao/runbooks/scheduling.md) para detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}

### Descrição

Este runbook agendado consulta todos os dispositivos geridos pelo Intune e identifica dispositivos que partilham o mesmo nome de apresentação. Para cada conjunto de duplicados, o dispositivo inscrito mais recentemente é renomeado para um nome gerado composto por um prefixo configurável seguido de dígitos aleatórios preenchidos até ao comprimento total especificado, e esse nome é persistido no objeto de dispositivo Windows Autopilot correspondente. Um filtro de SO opcional restringe o processamento a uma plataforma específica (Windows, macOS ou outra); quando definido como All, são avaliados dispositivos de todas as plataformas.

### Localização

Organização → Dispositivos → Deduplicar nomes de dispositivos (Agendado)

**Nome completo do runbook**

rjgit-org\_devices\_dedup-device-names\_scheduled

### Detalhes

| Propriedade         | Valor                                                                                   |
| ------------------- | --------------------------------------------------------------------------------------- |
| Versão              | 1.0.2                                                                                   |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)</p> |
| Agendável           | sim                                                                                     |

### Notas

Pré-requisitos:

* A identidade gerida deve ter atribuídas as permissões de aplicação Graph DeviceManagementManagedDevices.ReadWrite.All e DeviceManagementServiceConfig.ReadWrite.All.
* As alterações ao nome de apresentação do Autopilot através de updateDeviceProperties entram em vigor na próxima sincronização do dispositivo e podem não ser refletidas imediatamente no portal.

Interações de parâmetros:

* NameLength tem de ser estritamente maior do que o número de caracteres de NamePrefix. A diferença determina quantos dígitos aleatórios são acrescentados (por exemplo, NamePrefix "CORP" com NameLength 8 produz nomes como "CORP4271").
* O runbook valida esta restrição ao iniciar e falha imediatamente se for violada.

Casos de uso comuns:

* Agende semanalmente para resolver automaticamente nomes de dispositivos duplicados que surjam de reinscrição, reimagem do SO ou fluxos de trabalho de clonagem.
* O caminho de sincronização idempotente do Autopilot garante que dispositivos exclusivos também sejam normalizados no Autopilot, mesmo na primeira execução.

### Permissões

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

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Lista todos os dispositivos geridos pelo Intune e renomeia duplicados através de setDeviceName*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Lê windowsAutopilotDeviceIdentities e sincroniza os novos nomes através de updateDeviceProperties*
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Necessário para a ação privilegiada setDeviceName ao renomear duplicados*

### Parâmetros

#### NamePrefix

O prefixo fixo usado no início de cada nome de dispositivo gerado. Todos os dispositivos renomeados começarão com esta string.

| Propriedade                | Valor                          |
| -------------------------- | ------------------------------ |
| Obrigatório                | verdadeiro                     |
| Valor padrão               |                                |
| Tipo                       | String                         |
| Nome de exibição no portal | Prefixo do nome do dispositivo |

#### NameLength

O comprimento total em caracteres do nome do dispositivo gerado, incluindo o prefixo. Tem de ser maior do que o comprimento de NamePrefix para haver espaço para o sufixo de dígitos aleatórios.

| Propriedade                | Valor                                           |
| -------------------------- | ----------------------------------------------- |
| Obrigatório                | verdadeiro                                      |
| Valor padrão               | 0                                               |
| Tipo                       | Int32                                           |
| Nome de exibição no portal | Comprimento total do nome (incluindo o prefixo) |

#### OsFilter

Restringe quais dispositivos são avaliados para deteção e renomeação de duplicados. All inclui todas as plataformas; Windows e MacOS processam apenas essas plataformas; Other abrange Android, iOS, ChromeOS e qualquer SO não reconhecido. O padrão é All.

| Propriedade                | Valor                       |
| -------------------------- | --------------------------- |
| Obrigatório                | falso                       |
| Valor padrão               | Todos                       |
| Tipo                       | String                      |
| Nome de exibição no portal | Filtro do sistema operativo |

**Opções do portal**

| Opção do portal                 | Valor |
| ------------------------------- | ----- |
| Todas as plataformas            |       |
| Apenas Windows                  |       |
| Apenas macOS                    |       |
| Outros (Android, iOS, ChromeOS) |       |

[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/dedup-device-names_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.
