Knowledge Base
Bestehende Installationen über die Befehlszeile zuweisen
Zuletzt bearbeitet: 24.09.2025
Ein Gerät über die Befehlzeile zuweisen
- Öffnen Sie CMD (Windows) oder das Terminal (macOS).
- Gehen Sie zu Ihrem TeamViewer Installationsordner.
- Geben Sie den folgenden Befehl (siehe unten) in die Befehlszeile ein.
- Bestätigen Sie mit der Eingabe-Taste.
- (optional für Windows): Geben Sie folgenden Befehl ein, um zu prüfen ob der Prozess erfolgreich war:
echo %errorlevel%
- Wenn die Zuweisung erfolgreich war, sollte der Wert „0“ an die Befehlszeile zurückgegeben werden.
- Jeder andere Rückgabewert weist auf ein Problem hin, das während der Zuweisung aufgetreten ist. Weitere Informationen finden Sie im Abschnitt Fehlercodes.
Optionale Befehlszeilenoptionen
Es gibt weitere Optionen, die Sie Ihrer Befehlszeile hinzufügen können:
Alias
Für Windows:
--device-alias=[<name>]
Alias für das neue Gerät in der Geräteliste. Die Eigenschaft kann die folgenden Werte annehmen:
- --alias (ohne Wert)
- Alias des Computer wird die TeamViewer ID sein
- --alias hello
- Alias des Computers word "hello" sein
- Alias parameter nicht angegeben
- Alias des Computers word der %computername% sein
- --alias %systemvariable%
- Alias wird die Systemvariable z.B. %username% sein
Beispiel:
C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME%-%USERNAME%
Tipp: Wenn Sie Leerzeichen verwenden möchten, müssen Sie alles in "..." einfügen:
C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME% Test %USERNAME%“
Retries
--retries
Bei vorübergehenden Fehlern wird die Zuweisung erneut versucht. Beachten Sie, dass zwischen jedem Versuch eine Wartezeit von 1 Sekunde liegt.
Timeout
--timeout
Legen Sie die Gesamtzeit in Sekunden fest, die für alle Zuweisungsversuche verwendet wird.
Beispiel:
TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID --retries=3 --timeout=120
--offline
Um Geräte zu verwalten, die während der Zuweisung offline sind, speichert es die Zuweisung als verschlüsselter Parameter im Zuweisungsprozess und führt sie automatisch aus, sobald das Gerät wieder online ist. Dieser Parameter wird gelöscht, sobald das Gerät erfolgreich zugewiesen wurde.
Das Gerät neu zuweisen mit derselben Zuweisungs-ID
--reassign
Mit diesem Parameter können Sie ein Gerät unter Verwendung derselben Zuweisungs-ID neu zuweisen. Standardmäßig lehnen Geräte Neuzuweisungsversuche ab, wenn sich die Zuweisungs-ID nicht geändert hat. Mit --reassign wird die vorhandene Zuweisungs-ID auf dem Gerät erzwungen, was in Szenarien nützlich sein kann, in denen die Zuweisung erneut angewendet werden muss, ohne eine neue Zuweisungs-ID zu generieren.
Fehlercodes
| Fehlercode | Beschreibung | Problem/Lösung |
|---|---|---|
1 | Invalid command line arguments | Womöglich haben Sie einen Tippfehler oder Sie haben ein falsches Kommando benutzt. Bitte überprüfen Sie Ihre Kommando und versuchen Sie es erneut. |
2 | Signature verification error | - |
3 | Product not installed | TeamViewer ist nicht installiert. Installieren Sie TeamViewer vor der Zuweisung. |
4 | Service config - access failed | //ComAPI |
400 (40 under Linux/FreeBSD) | MDv2Assignment - invalid argument | Es scheint ein Fehler in der Befehlszeilensyntax vorzuliegen oder es wird eine ungültige Zuweisungs-ID verwendet. Bitte überprüfen Sie die gesamte Befehlszeilensyntax und stellen Sie sicher, dass die kopierte Zuweisungs-ID eine gültige Konfiguration aus der Management Console ist. |
401 (41 under Linux/FreeBSD) | MDv2Assignment - service not running | Die Zuweisung kann nicht ausgeführt werden, weil TeamViewer nicht richtig läuft. Bitte überprüfen Sie, ob der TeamViewer Dienst läuft. |
402 (42 under Linux/FreeBSD) | MDv2Assignment - service incompatible version | Der TeamViewer Dienst ist nicht kompatibel mit der ausgeführten TeamViewer Version. Es scheint, dass die Installation nicht korrekt abgeschlossen wurde. Bitte überprüfen Sie die Installation und installieren Sie TeamViewer ggf. erneut. |
403 (43 under Linux/FreeBSD) | MDv2Assignment - not online | Der TeamViewer Client konnte sich nicht mit der TeamViewer Cloud verbinden, um Ihr Gerät zuzuordnen. Überprüfen Sie bitte, ob der Client online ist und ob Ihre Internetverbindung ordnungsgemäß funktioniert. |
404 (44 under Linux/FreeBSD) | MDv2Assignment - already running | Es läuft bereits ein anderer Zuweisungsprozess. Bitte überprüfen Sie den Status dieser Zuweisung. Sie können dies beispielsweise tun, indem Sie prüfen, ob das Gerät bereits als verwaltetes Gerät in der Management Console registriert ist. |
405 (45 under Linux/FreeBSD) | MDv2Assignment - timeout | Ihr Zuweisungsversuch wurde abgebrochen. Bitte versuchen Sie es erneut. |
406 (46 under Linux/FreeBSD) | MDv2Assignment - failed | Ihre Zuweisung ist aus unbekannten Gründen fehlgeschlagen. Bitte speichern Sie Ihre Logs und kontaktieren Sie den Support. |
407 (47 under Linux/FreeBSD) | MDv2Assignment - access denied | Sie haben nicht die erforderliche Berechtigung, um eine Zuweisung durchzuführen. Stellen Sie sicher, dass Ihr Benutzer über lokale Administratorrechte verfügt. |
408 (48 under Linux/FreeBSD) | MDv2Assignment - Denied by policy | Die auf diesem Gerät aktive TeamViewer Richtlinie verhindert das Entfernen der bestehenden Kontozugehörigkeit. Bitte deaktivieren Sie die Richtlinie in der Management Console.
Hinweis: Eine Neuzuweisung entfernt implizit den bestehenden Status und wird daher ebenfalls verweigert |
409 | MDv2Assignment - Geräte bereits gemanaged | Das Gerät ist bereits mit derselben Zuweisungs-ID Ihrem Unternehmen zugeordnet. |
Eine Zuweisung aktualisieren/ überschreiben
Wenn Sie bereits ein Gerät zugewiesen haben und die Zuweisung erneut über die Befehlszeile ausführen, wird die Gerätezuweisung durch die neue überschrieben. Überschreiben bedeutet, dass die alte Zuweisung gelöscht wird und bereits zugewiesene Manager oder Richtlinien verloren gehen.
Hinweis: Die TeamViewer Richtlinie „verhindert die Aufhebung der Zuweisung“ verhindert auch eine neue Zuweisung für ein bereits zugewiesenes Gerät.