> 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).

# Gerätenamen deduplizieren geplant

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

### Beschreibung

Dieses geplante Runbook fragt alle von Intune verwalteten Geräte ab und identifiziert Geräte, die denselben Anzeigenamen haben. Für jede Gruppe von Duplikaten wird das zuletzt registrierte Gerät in einen generierten Namen umbenannt, der aus einem konfigurierbaren Präfix gefolgt von zufälligen Ziffern besteht, die auf die angegebene Gesamtlänge aufgefüllt werden, und dieser Name wird im passenden Windows Autopilot-Geräteobjekt gespeichert. Ein optionaler Betriebssystemfilter schränkt die Verarbeitung auf eine bestimmte Plattform (Windows, macOS oder andere) ein; bei Einstellung auf All werden Geräte aller Plattformen ausgewertet.

### Ort

Organisation → Geräte → Gerätenamen deduplizieren (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.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)</p> |
| Planbar              | ja                                                                                      |

### Notizen

Voraussetzungen:

* Der verwalteten Identität müssen die Graph-Anwendungsberechtigungen DeviceManagementManagedDevices.ReadWrite.All und DeviceManagementServiceConfig.ReadWrite.All zugewiesen sein.
* Änderungen des Anzeigenamens in Autopilot über updateDeviceProperties werden bei der nächsten Gerätesynchronisierung wirksam und werden möglicherweise nicht sofort im Portal angezeigt.

Parameterwechselwirkungen:

* NameLength muss strikt größer sein als die Zeichenzahl von NamePrefix. Die Differenz bestimmt, wie viele Zufallsziffern angehängt werden (z. B. erzeugt NamePrefix "CORP" mit NameLength 8 Namen wie "CORP4271").
* Das Runbook überprüft diese Einschränkung beim Start und beendet sich bei einem Verstoß sofort.

Häufige Anwendungsfälle:

* Planen Sie eine wöchentliche Ausführung, um doppelte Gerätenamen automatisch zu beheben, die durch erneute Registrierung, Neuaufsetzen des Betriebssystems oder Klon-Workflows entstehen.
* Der idempotente Autopilot-Synchronisierungsweg stellt sicher, dass eindeutige Geräte auch bei der ersten Ausführung in Autopilot normalisiert werden.

### Berechtigungen

#### Anwendungsberechtigungen

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

### Parameter

#### NamePrefix

Das feste Präfix, das am Anfang jedes generierten Gerätenamens verwendet wird. Alle umbenannten Geräte beginnen mit dieser Zeichenfolge.

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

#### NameLength

Die gesamte Zeichenlänge des generierten Gerätenamens einschließlich des Präfixes. Muss größer sein als die Länge von NamePrefix, damit Platz für den Suffix aus zufälligen Ziffern bleibt.

| Eigenschaft           | Wert                                        |
| --------------------- | ------------------------------------------- |
| Erforderlich          | wahr                                        |
| Standardwert          | 0                                           |
| Typ                   | Int32                                       |
| Anzeigename im Portal | Gesamte Namenslänge (einschließlich Präfix) |

#### OsFilter

Schränkt ein, welche Geräte für die Erkennung von Duplikaten und das Umbenennen ausgewertet werden. All umfasst alle Plattformen; Windows und MacOS verarbeiten nur diese Plattformen; Other umfasst Android, iOS, ChromeOS und jedes nicht erkannte Betriebssystem. Standardmäßig All.

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

**Portaloptionen**

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

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