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

# Deduplicar nomes de dispositivos agendado

Mudar o nome de dispositivos do Intune que partilham um nome apresentado

{% 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

Localiza dispositivos do Intune que compartilham o mesmo nome de exibição e renomeia o mais recentemente inscrito de cada conjunto. O nome gerado é um prefixo fixo seguido de dígitos aleatórios até o comprimento total escolhido. O novo nome também é gravado no registro correspondente do Windows Autopilot. Um filtro de sistema operacional limita quais plataformas são verificadas.

### Casos de uso comuns

* Agende o runbook semanalmente para resolver automaticamente nomes de dispositivos duplicados que surgem de reinscrição, reimagem do sistema operacional ou fluxos de trabalho de clonagem.
* O caminho de sincronização do Autopilot é idempotente, portanto dispositivos únicos também são normalizados no Autopilot, inclusive na primeira execução.

### Interações entre parâmetros

* `NameLength` deve ser estritamente maior que o número de caracteres em `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 essa restrição na inicialização e falha rapidamente quando ela é violada.

### Comportamento

Alterações no nome de exibição do Autopilot feitas por meio de `updateDeviceProperties` entram em vigor na próxima sincronização do dispositivo e podem não ser refletidas imediatamente no portal.

### 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.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Agendável           | sim                                                                                      |

### Permissões

#### Permissões de aplicativo

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

### Parâmetros

#### NamePrefix

Início fixo de cada nome gerado, por exemplo PC-.

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

#### NameLength

Comprimento do nome gerado, incluindo o prefixo; o restante é preenchido com dígitos aleatórios, portanto ele deve ser maior que o prefixo.

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

#### Filtro de SO

Quais plataformas são verificadas: todas, apenas Windows, apenas macOS ou as demais (Android, iOS, ChromeOS).

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

**Opções do portal**

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

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