Sie können während der Installation die Geräte direkt Ihrem Konto mithilfe einer Befehlzeile zuweisen.

Dieser Artikel richtet sich an alle mit einer Corporate oder Tensor Lizenz, die TeamViewer (Version 15 und neuer) ausrollen möchten.

Ein Gerät über die Befehlzeile zuweisen

  1. Öffnen Sie CMD (Windows) oder das Terminal (macOS).
  2. Gehen Sie zu Ihrem TeamViewer Installationsordner.
  3. Geben Sie den folgenden Befehl (siehe unten) in die Befehlszeile ein.
  4. Bestätigen Sie mit der Eingabe-Taste.
  5. (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.

TeamViewer.exe assignment --id paste_your_assignment_id_here --offline 

Beispiel: 

TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline 

Voraussetzungen:

  • TeamViewer ist bereits installiert.
  • Für den TeamViewer Full Client muss die Option Mit macOS starten aktiviert werden.

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

sudo teamviewer assignment --id paste_your_assignment_id_here --offline 

Beispiel:

sudo teamviewer assignment --id 0001CoABChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAO4PLaOBrqNDgr6jwtNCVK_JiM5lVdgdfgYo3uQ3pGkAbX8bo_VqPw1Rt61-RLe9AKSwZ14uwOXtUN7FYflrHbWAqRKBF0h8V18ldMcVT1rLF --offline

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:

  1. --alias (ohne Wert)
    • Alias des Computer wird die TeamViewer ID sein
  2. --alias hello
    • Alias des Computers word "hello" sein
  3. Alias parameter nicht angegeben
    • Alias des Computers word der %computername% sein
  4. --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.

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
Die Zuweisungskonfiguration konnte nicht mit der TeamViewer Cloud abgeglichen werden. Bitte versuchen Sie es später erneut.

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
(49 under Linux/Free BSD)

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.