> 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. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}

### Descrição

Encontra dispositivos do Intune que partilham o mesmo nome de apresentação e renomeia o mais recentemente inscrito de cada conjunto. O nome gerado é um prefixo fixo seguido de dígitos aleatórios até ao comprimento total escolhido. O novo nome também é escrito no registo correspondente do Windows Autopilot. Um filtro de SO limita quais plataformas são verificadas.

### Casos de uso comuns

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

### Interações entre parâmetros

* `NameLength` deve ser estritamente maior do 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 esta restrição no arranque e falha rapidamente quando é violada.

### Comportamento

As alterações ao nome de apresentação do Autopilot feitas via `updateDeviceProperties` entram em vigor na próxima sincronização do dispositivo e podem não ficar refletidas no portal imediatamente.

### 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 da aplicação

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

### Parâmetros

#### NamePrefix

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

| Propriedade                | Valor                          |
| -------------------------- | ------------------------------ |
| Obrigatório                | verdadeiro                     |
| Valor predefinido          |                                |
| Tipo                       | Cadeia de caracteres           |
| Nome de exibição do portal | Prefixo do nome do dispositivo |

#### NameLength

Comprimento do nome gerado, incluindo o prefixo; o restante é preenchido com dígitos aleatórios, por isso tem de ser maior do que o prefixo.

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

#### OsFilter

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

| Propriedade                | Valor                       |
| -------------------------- | --------------------------- |
| Obrigatório                | falso                       |
| Valor predefinido          | Todos                       |
| Tipo                       | Cadeia de caracteres        |
| Nome de exibição do portal | Filtro do sistema operativo |

**Opções do portal**

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

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