> 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/de/automatisierung/runbooks/runbook-references/org/devices/dedup-device-names_scheduled.md).

# Doppelte Gerätenamen bereinigen, geplant

Intune-Geräte mit demselben Anzeigenamen umbenennen

{% hint style="info" %}
Dies ist ein geplantes Runbook. Es ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, statt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Zeitplanung](https://docs.realmjoin.com/de/automatisierung/runbooks/scheduling.md) für Details zur Konfiguration von Runbook-Zeitplänen.
{% endhint %}

### Beschreibung

Findet Intune-Geräte, die denselben Anzeigenamen haben, und benennt jeweils das zuletzt registrierte Gerät jedes Satzes um. Der generierte Name besteht aus einem festen Präfix gefolgt von zufälligen Ziffern bis zur gewählten Gesamtlänge. Der neue Name wird außerdem in den zugehörigen Windows Autopilot-Datensatz geschrieben. Ein Betriebssystemfilter schränkt ein, welche Plattformen geprüft werden.

### Häufige Anwendungsfälle

* Planen Sie das Runbook wöchentlich, um doppelte Gerätenamen automatisch zu beheben, die durch erneute Registrierung, OS-Reimaging oder Klon-Workflows entstehen.
* Der Autopilot-Synchronisierungspfad ist idempotent, sodass eindeutige Geräte auch in Autopilot normalisiert werden, ebenfalls beim ersten Lauf.

### Parameterwechselwirkungen

* `NameLength` muss strikt größer sein als die Anzahl der Zeichen in `NamePrefix`. Die Differenz bestimmt, wie viele zufällige Ziffern angehängt werden; zum Beispiel, `NamePrefix` "CORP" mit `NameLength` 8 erzeugt Namen wie "CORP4271".
* Das Runbook validiert diese Einschränkung beim Start und bricht sofort mit einem Fehler ab, wenn sie verletzt wird.

### Verhalten

Änderungen des Autopilot-Anzeigenamens, die über `updateDeviceProperties` vorgenommen werden, werden erst bei der nächsten Gerätesynchronisierung wirksam und sind im Portal möglicherweise nicht sofort sichtbar.

### Ort

Organisation → Geräte → Dedupliziere Gerätenamen (Geplant)

**Vollständiger Runbook-Name**

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

### Details

| Eigenschaft          | Wert                                                                                     |
| -------------------- | ---------------------------------------------------------------------------------------- |
| Version              | 1.0.2                                                                                    |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Planbar              | ja                                                                                       |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Listet alle von Intune verwalteten Geräte auf und benennt doppelte Einträge über setDeviceName um*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Liest windowsAutopilotDeviceIdentities und synchronisiert neue Namen über updateDeviceProperties*
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Erforderlich für die privilegierte Aktion setDeviceName beim Umbenennen doppelter Einträge*

### Parameter

#### NamePrefix

Fester Beginn jedes generierten Namens, zum Beispiel PC-.

| Eigenschaft           | Wert              |
| --------------------- | ----------------- |
| Erforderlich          | wahr              |
| Standardwert          |                   |
| Typ                   | Zeichenfolge      |
| Anzeigename im Portal | Gerätenamenpräfix |

#### NameLength

Länge des generierten Namens einschließlich des Präfixes; der Rest wird mit zufälligen Ziffern aufgefüllt, daher muss er länger als das Präfix sein.

| Eigenschaft           | Wert                   |
| --------------------- | ---------------------- |
| Erforderlich          | wahr                   |
| Standardwert          | 0                      |
| Typ                   | Int32                  |
| Anzeigename im Portal | Gesamtlänge des Namens |

#### OsFilter

Welche Plattformen geprüft werden: alle, nur Windows, nur macOS oder die anderen (Android, iOS, ChromeOS).

| Eigenschaft           | Wert                 |
| --------------------- | -------------------- |
| Erforderlich          | falsch               |
| Standardwert          | Alle                 |
| Typ                   | Zeichenfolge         |
| Anzeigename im Portal | Betriebssystemfilter |

**Portaloptionen**

| Portaloption                    | Wert    |
| ------------------------------- | ------- |
| Alle Plattformen                | Alle    |
| nur Windows                     | Windows |
| nur macOS                       | macOS   |
| Andere (Android, iOS, ChromeOS) | Andere  |

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/de/automatisierung/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/de/automatisierung/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.
