Knowledge Base
Vorhandene TeamViewer Installationen über die Befehlszeile zuweisen
Zuletzt bearbeitet: 16.11.2026
Wie kann ich ein Gerät über die Befehlszeile zuweisen?
Um ein Windows-Gerät über die Befehlszeile zuzuweisen, folgen Sie bitte den untenstehenden Anweisungen:
- Öffnen Sie die CMD.
- Navigieren Sie zu Ihrem TeamViewer-Installationsordner.
- Geben Sie den folgenden Befehl (unten angegeben) in die Befehlszeile ein.
- Drücken Sie die Eingabetaste auf Ihrer Tastatur.
- (Optional) Geben Sie
echo %errorlevel%
in die Befehlszeile ein, um zu überprüfen, ob der Vorgang erfolgreich war:
- Wenn die Zuweisung erfolgreich war, sollte der Wert „0“ in der 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.
TeamViewer.exe assignment --id paste_your_assignment_id_here --offline
Beispiel:
TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Optionale Befehlszeilenoptionen
Sie können Ihrer Befehlszeile weitere Optionen hinzufügen:
Alias
--device-alias=[<name>]
Alias für das neue Gerät, wie es in der Geräteliste angezeigt wird. Diese Eigenschaft kann die folgenden Werte annehmen:
- --alias (ohne Wert)
- Alias des Geräts entspricht der TeamViewer ID
- --alias hello
- Alias des Geräts lautet "hello"
- Alias-Parameter nicht angegeben
- Alias dieses Geräts entspricht %computername%
- --alias %systemvariable%
- Als Alias wird die verwendete Systemvariable verwendet, z.B. %username%
Beispiel:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME%-%USERNAME%
Hinweis: Wenn Sie Leerzeichen verwenden möchten, müssen Sie den gesamten Wert wie im folgenden Beispiel in Anführungszeichen setzen:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME% Test %USERNAME%“
Wiederholungsversuche
--retries
Bei vorübergehenden Fehlern wird die Zuweisung erneut versucht. Zwischen den einzelnen Versuchen beträgt die Wartezeit 1 Sekunde.
Timeout
--timeout
Legen Sie den gesamten Timeout in Sekunden für alle Zuweisungsversuche fest.
Beispiel:
TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID
--retries=3 --timeout=120
Für Offline-Geräte
--offline
Um Geräte zu berücksichtigen, die während der Zuweisung offline sind, wird die Zuweisung als verschlüsselte Eigenschaft in der Registry gespeichert und automatisch ausgeführt, sobald das Gerät wieder online ist. Diese Eigenschaft wird gelöscht, sobald das Gerät erfolgreich zugewiesen wurde.
Für eine erneute Zuweisung mit derselben Zuweisungs-ID
--reassign
Mit diesem Parameter können Sie ein Gerät mit derselben Zuweisungs-ID erneut zuweisen. Standardmäßig lehnen Geräte eine erneute Zuweisung ab, wenn sich die Zuweisungs-ID nicht geändert hat. Mit --reassign wird die vorhandene Zuweisungs-ID auf dem Gerät erzwungen. Dies kann hilfreich sein, wenn eine Zuweisung erneut angewendet werden muss, ohne eine neue Zuweisungs-ID zu generieren.
Fehlercodes
| Fehlercode | Beschreibung | Problem/Lösung |
|---|---|---|
1 | Ungültige Befehlszeilenargumente | Der Befehl enthält möglicherweise einen Tippfehler oder ist ungültig. Überprüfen Sie den Befehl und versuchen Sie es erneut. |
2 | Fehler bei der Signaturprüfung | - |
3 | Produkt nicht installiert | TeamViewer ist nicht installiert. Installieren Sie TeamViewer, bevor Sie eine Zuweisung durchführen. |
4 | Servicekonfiguration – Zugriff fehlgeschlagen | // ComAPI Die Zuweisungskonfiguration konnte nicht anhand der TeamViewer Cloud überprüft werden. Versuchen Sie es später erneut. |
400 (40 unter Linux/FreeBSD) | MDv2Assignment - Ungültiges Argument | Möglicherweise liegt ein Fehler in der Syntax der Befehlszeile vor oder es wird eine ungültige Zuweisungs-ID verwendet. Überprüfen Sie die gesamte Syntax und stellen Sie sicher, dass die kopierte Zuweisungs-ID eine gültige Konfiguration aus der Management Console ist. |
401 (41 unter Linux/FreeBSD) | MDv2Assignment - Service läuft nicht | Die Zuweisung kann nicht durchgeführt werden, da TeamViewer nicht ordnungsgemäß ausgeführt wird. Stellen Sie sicher, dass der TeamViewer Service ausgeführt wird. |
402 (42 unter Linux/FreeBSD) | MDv2Assignment - inkompatible Serviceversion | Der TeamViewer Service ist nicht mit der ausgeführten TeamViewer Client-Version kompatibel. Die Installation wurde möglicherweise nicht ordnungsgemäß abgeschlossen. Überprüfen Sie die Installation und installieren Sie TeamViewer bei Bedarf erneut. |
403 (43 unter Linux/FreeBSD) | MDv2Assignment - nicht online | Der TeamViewer Client konnte keine Verbindung zur TeamViewer Cloud herstellen, um das Gerät zuzuweisen. Stellen Sie sicher, dass der Client online ist und die Internetverbindung ordnungsgemäß funktioniert. Versuchen Sie die Zuweisung anschließend erneut. Wenn dies häufig auftritt, sollten Sie die Option --retries verwenden |
404 (44 unter Linux/FreeBSD) | MDv2Assignment - wird bereits ausgeführt | Ein anderer Zuweisungsvorgang wird bereits ausgeführt. Überprüfen Sie den Status dieser Zuweisung, beispielsweise indem Sie prüfen, ob das Gerät bereits als verwaltetes Gerät in der Management Console registriert ist. |
405 (45 unter Linux/FreeBSD) | MDv2Assignment – Zeitüberschreitung | Beim Zuweisungsversuch ist ein Timeout aufgetreten. Versuchen Sie es erneut. Wenn dies häufig auftritt oder das Netzwerk instabil ist, z.B. bei Mobilfunkverbindungen, sollten Sie den Timeout über die Befehlszeile erhöhen. |
406 (46 unter Linux/FreeBSD) | MDv2Assignment - fehlgeschlagen | Die Zuweisung ist aus unbekannten Gründen fehlgeschlagen. Speichern Sie Ihre Protokolle und wenden Sie sich an den Support. |
407 (47 unter Linux/FreeBSD) | MDv2Assignment - Zugriff verweigert | Sie verfügen nicht über die erforderliche Berechtigung zum Ausführen einer Zuweisung. Stellen Sie sicher, dass Ihr Benutzer über lokale Admin-Rechte verfügt. |
408 (48 unter Linux/FreeBSD) | MDv2Assignment - durch Richtlinie verweigert | Die auf diesem Gerät aktive TeamViewer Richtlinie verhindert das Entfernen des bestehenden Zuweisungsstatus. Deaktivieren Sie die Richtlinie in der Management Console.
Hinweis: Bei einer erneuten Zuweisung wird der bestehende Status implizit entfernt. Daher wird auch eine erneute Zuweisung verhindert. |
409 | MDv2Assignment - Gerät wird bereits verwaltet | Das Gerät ist Ihrem Unternehmen bereits mit derselben Zuweisungs-ID zugewiesen. |
Voraussetzungen:
- TeamViewer ist bereits installiert.
- Beim TeamViewer Client muss die Option Mit macOS starten aktiviert sein.
Um ein macOS-Gerät über die Befehlszeile zuzuweisen, folgen Sie bitte den nachstehenden Anweisungen:
- Öffnen Sie das Terminal.
- Geben Sie den folgenden Befehl (unten angegeben) in die Befehlszeile ein.
- Drücken Sie die Eingabetaste auf Ihrer Tastatur.
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id <ID> --offline
Beispiel:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id paste_your_assignment_id_here --offline
Beispiel:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Optionale Befehlszeilenoptionen
Sie können Ihrer Befehlszeile folgende zusätzliche Optionen hinzufügen:
Alias
-device_alias [<name>]
Alias für das neue Gerät in der Geräteliste. Wenn sich das Gerät bereits in der Kontaktliste befindet, wird kein Alias angewendet. Die Eigenschaft kann die folgenden Werte annehmen:
- --alias (ohne Wert)
- Alias des Geräts entspricht der TeamViewer ID
- --alias hello
- Alias des Geräts lautet "hello"
--offline
Um Geräte zu berücksichtigen, die während der Zuweisung offline sind, wird die Zuweisung als verschlüsselte Eigenschaft in der Registry gespeichert und automatisch ausgeführt, sobald das Gerät wieder online ist. Diese Eigenschaft wird gelöscht, sobald das Gerät erfolgreich zugewiesen wurde.
Für eine erneute Zuweisung mit derselben Zuweisungs-ID
--reassign
Mit diesem Parameter können Sie ein Gerät mit derselben Zuweisungs-ID erneut zuweisen. Standardmäßig lehnen Geräte eine erneute Zuweisung ab, wenn sich die Zuweisungs-ID nicht geändert hat. Mit --reassign wird die vorhandene Zuweisungs-ID auf dem Gerät erzwungen. Dies kann hilfreich sein, wenn eine Zuweisung erneut angewendet werden muss, ohne eine neue Zuweisungs-ID zu generieren.
sudo teamviewer assignment --id paste_your_assignment_id_here --offline
Beispiel:
sudo teamviewer assignment --id 0001CoABChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAO4PLaOBrqNDgr6jwtNCVK_JiM5lVdgdfgYo3uQ3pGkAbX8bo_VqPw1Rt61-RLe9AKSwZ14uwOXtUN7FYflrHbWAqRKBF0h8V18ldMcVT1rLF --offline
Optionale Befehlszeilenoptionen
Sie können Ihrer Befehlszeile folgende zusätzliche Optionen hinzufügen:
Alias
--device_alias [<name>]
Alias für das neue Gerät in der Geräteliste. Wenn sich das Gerät bereits in der Kontaktliste befindet, wird kein Alias angewendet. Die Eigenschaft kann die folgenden Werte annehmen:
- --alias (ohne Wert)
- Alias des Geräts entspricht der TeamViewer ID
- --alias hello
- Alias des Geräts lautet "hello"
--offline
Um Geräte zu berücksichtigen, die während der Zuweisung offline sind, wird die Zuweisung als verschlüsselte Eigenschaft in der Registry gespeichert und automatisch ausgeführt, sobald das Gerät wieder online ist. Diese Eigenschaft wird gelöscht, sobald das Gerät erfolgreich zugewiesen wurde.
Für die erneute Zuweisung mit derselben Zuweisungs-ID
--reassign
Mit diesem Parameter können Sie ein Gerät mit derselben Zuweisungs-ID erneut zuweisen. Standardmäßig lehnen Geräte eine erneute Zuweisung ab, wenn sich die Zuweisungs-ID nicht geändert hat. Mit --reassign wird die vorhandene Zuweisungs-ID auf dem Gerät erzwungen. Dies kann hilfreich sein, wenn eine Zuweisung erneut angewendet werden muss, ohne eine neue Zuweisungs-ID zu generieren.
Fehlercodes
| Fehlercode | Beschreibung | Problem/Lösung |
|---|---|---|
400 (40 unter Linux/FreeBSD) | MDv2Assignment - ungültiges Argument | Möglicherweise liegt ein Fehler in der Syntax der Kommandozeile vor oder es wird eine ungültige Zuweisungs-ID verwendet. Überprüfen Sie die gesamte Syntax und stellen Sie sicher, dass die kopierte Zuweisungs-ID eine gültige Konfiguration aus der Management Console ist. |
401 (41 unter Linux/FreeBSD) | MDv2Assignment - Service läuft nicht | Die Zuweisung kann nicht durchgeführt werden, da TeamViewer nicht ordnungsgemäß ausgeführt wird. Stellen Sie sicher, dass der TeamViewer Service ausgeführt wird. |
402 (42 unter Linux/FreeBSD) | MDv2Assignment - inkompatible Service-Version | Der TeamViewer Service ist nicht mit der ausgeführten TeamViewer Client-Version kompatibel. Die Installation wurde möglicherweise nicht ordnungsgemäß abgeschlossen. Überprüfen Sie die Installation und installieren Sie TeamViewer bei Bedarf erneut. |
403 (43 unter Linux/FreeBSD) | MDv2Assignment - nicht online | Der TeamViewer Client konnte keine Verbindung zur TeamViewer Cloud herstellen, um das Gerät zuzuweisen. Stellen Sie sicher, dass der Client online ist und die Internetverbindung ordnungsgemäß funktioniert. Versuchen Sie die Zuweisung anschließend erneut. Wenn dies häufig auftritt, sollten Sie die Option für Wiederholungsversuche in der Kommandozeile verwenden. |
404 (44 unter Linux/FreeBSD) | MDv2Assignment - läuft bereits | Ein anderer Zuweisungsvorgang wird bereits ausgeführt. Überprüfen Sie dessen Status, beispielsweise indem Sie prüfen, ob das Gerät bereits als verwaltetes Gerät in der Management Console registriert ist. |
405 (45 unter Linux/FreeBSD) | MDv2Assignment - Timeout | Beim Zuweisungsversuch ist ein Timeout aufgetreten. Versuchen Sie es erneut. Wenn dies häufig auftritt oder das Netzwerk instabil ist, z.B. bei Mobilfunkverbindungen, sollten Sie den Timeout in der Befehlszeile erhöhen. |
406 (46 unter Linux/FreeBSD) | MDv2Assignment - fehlgeschlagen | Die Zuweisung ist aus unbekannten Gründen fehlgeschlagen. Speichern Sie Ihre Protokolle und wenden Sie sich an den Support. |
407 (47 unter Linux/FreeBSD) | MDv2Assignment - Zugriff verweigert | Sie verfügen nicht über die erforderliche Berechtigung zum Ausführen einer Zuweisung. Stellen Sie sicher, dass Ihr Benutzer über lokale Admin-Rechte verfügt. |
408 (48 unter Linux/FreeBSD) | MDv2Assignment - durch Richtlinie verweigert | Die auf diesem Gerät aktive TeamViewer Richtlinie verhindert das Entfernen des bestehenden Zuweisungsstatus. Deaktivieren Sie die Richtlinie in der Management Console.
Hinweis: Bei einer erneuten Zuweisung wird der bestehende Status implizit entfernt. Daher wird auch eine erneute Zuweisung verhindert. |
Wie kann ich eine Zuweisung aktualisieren/überschreiben?
Wenn ein Gerät bereits zugewiesen ist und Sie die Zuweisung erneut über die Befehlszeile ausführen, wird die bestehende Gerätezuweisung durch die neue überschrieben. Beim Überschreiben wird die alte Zuweisung gelöscht. Bereits zugewiesene Manager oder Richtlinien gehen dabei verloren.
Hinweis: Die TeamViewer Richtlinie Entfernen der Zuweisung verhindern verhindert auch eine neue Zuweisung auf einem bereits zugewiesenen Gerät.