Wenn Sie ein Gerät klonen, auf dem der Level-Agent bereits installiert ist, teilen sowohl das Original als auch der Klon dieselbe Agent-ID. Das verursacht einen Konflikt — die beiden Geräte konkurrieren um denselben Eintrag in Level, und eines oder beide zeigen eine fehlerhafte Konnektivität. Dieser Artikel zeigt, wie Sie die Agent-ID auf dem geklonten Gerät rotieren, um es zu beheben.
ℹ️ HINWEIS: Dies wirkt sich nur auf geklonte Geräte aus. Die Neuinstallation des Agenten auf einem vorhandenen Gerät ändert seine ID nicht — Level behält die ursprüngliche ID bei Neuinstallationen bei, um doppelte Einträge zu vermeiden.
Die Agent-ID Automatisch Rotieren
Die schnellste Lösung ist das Flag --new-agent-id. Es generiert eine neue UUID, aktualisiert die Konfiguration und startet den Agent in einem Schritt neu.
Führen Sie dies auf dem geklonten Gerät aus:
🖥️ PLATTFORMHINWEIS:
Windows:
& 'C:\Program Files\Level\level.exe' --new-agent-idmacOS:
sudo /usr/local/bin/level --new-agent-idLinux:
sudo /usr/local/bin/level --new-agent-id
Nach dem Neustart des Agenten registriert sich das geklonte Gerät als neuer Eintrag in Level. Das ursprüngliche Gerät ist nicht betroffen.
Die Agent-ID Manuell Rotieren
Wenn Sie die Agent-Binärdatei nicht direkt ausführen können (z. B. der Agent ist gestoppt oder die Binärdatei ist nicht zugänglich), können Sie die ID direkt in der Konfiguration bearbeiten.
⚠️ WARNUNG: Legen Sie den Wert auf eine gültige UUID v4 fest (zufällig generiert). Verwenden Sie keine ID von einem anderen Gerät und lassen Sie das Feld nicht leer. Nach der Bearbeitung starten Sie den Level-Dienst neu, damit die Änderung wirksam wird.
🖥️ PLATTFORMHINWEIS:
Windows — Registrierungsschlüssel:
Pfad:
HKEY_LOCAL_MACHINE\SOFTWARE\LevelSchlüsselname:
AgentIDÄndern Sie den Wert in eine neue UUID.
macOS — Konfigurationsdatei:
Pfad:
/Library/Application Support/Level/config.yamlSchlüsselname:
agent-idErsetzen Sie den vorhandenen Wert durch eine neue UUID.
Linux — Konfigurationsdatei:
Pfad:
/etc/level/config.yamlSchlüsselname:
agent-idErsetzen Sie den vorhandenen Wert durch eine neue UUID.
Nach der Bearbeitung starten Sie den Level-Dienst neu:
🖥️ PLATTFORMHINWEIS:
Windows:
Restart-Service -Name LevelmacOS:
sudo launchctl kickstart -k system/LevelLinux:
systemctl restart Level
Dies in Zukunft Verhindern
Zwei Optionen für klonbasierte Bereitstellungsworkflows:
Option 1 — UUID nach dem Klonen rotieren (empfohlen): Behalten Sie den Agent in Ihrem Master-Image und führen Sie --new-agent-id als Teil Ihres Bereitstellungsschritts nach dem Klonen aus (über MDM, Startup-Skript oder RMM). Jedes geklonte Gerät erhält automatisch eine neue ID beim ersten Start ohne manuelle Eingriffe.
Option 2 — Vor der Imageerstellung deinstallieren: Entfernen Sie den Level-Agent vor dem Erstellen des Master-Images und installieren Sie Level dann als Schritt nach dem Klonen. Jedes Gerät erhält eine neue Agent-ID bei der Installation.
💡 TIPP: Die Level-Installationshandbücher für Windows, macOS und Linux enthalten Silent-Install-Befehle, die für Bereitstellungsskripte und MDM-Workflows nach dem Klonen geeignet sind.
Häufig Gestellte Fragen
Auf welchem Gerät sollte ich --new-agent-id ausführen — dem Original oder dem Klon? Führen Sie es auf dem Klon aus. Das ursprüngliche Gerät hat die „richtige" ID, die bereits in Level registriert ist. Das Rotieren der ID des Klons registriert ihn als neues Gerät, ohne das Original zu stören.
Nach der ID-Rotation, erbt das geklonte Gerät die Gruppen, Tags und benutzerdefinierten Felder des Originals? Nein. Das geklonte Gerät registriert sich als brandneues Gerät in Level. Sie müssen es den entsprechenden Gruppen und Tags zuweisen. Benutzerdefinierte Feldwerte vom Original werden nicht übernommen.
Kann ich --new-agent-id durch Level pushen, wenn beide Geräte intermittierend angezeigt werden? Es ist unzuverlässig, wenn zwei Geräte um dieselbe ID konkurrieren. Lokaler Zugriff oder ein anderes Remotetool ist sicherer. Sobald Sie die ID auf dem Klon rotiert haben, haben beide Geräte stabile, separate Verbindungen.
Wie generiere ich eine gültige UUID für eine manuelle ID-Rotation? Unter Windows:
[guid]::NewGuid().ToString()in PowerShell. Unter macOS/Linux:uuidgen. Beide erzeugen eine gültige UUID v4.