Dieser Artikel richtet sich an TeamViewer Nutzer mit Windows oder macOS. Kunden mit einer Remote Access Lizenz können keine Fernsteuerungsverbindung per Kommandozeile aufbauen.
Einige Parameter sind nur bei der TeamViewer Version 13.2 verfügbar.
Befehlszeilenparameter auf Windows
Wie werden diese verwendet?
Parameter mit und ohne Wert
Es gibt zwei Arten von Parametern, solche mit und solche ohne Wert.
Beispiel für einen Parameter ohne Wert:
TeamViewer.exe --noInstallation
Beispiel für einen Parameter mit Wert:
TeamViewer.exe --id 123456789
In den meisten Fällen wird nur ein Wert erwartet. Werden mehrere Werte angegeben, wird nur der erste davon verwendet.
Falls der Parameterwert ein Leerzeichen enthält, muss der Wert zwischen " " gesetzt werden.
Weitere Informationen
Die Langvariante eines Parameters wird wie folgt aufgerufen (mit zwei „-“ --> „--“): TeamViewer.exe --Minimize
Falls der Parameter eine Kurzvariante hat, kann er mit nur einem „-“ aufgerufen werden: TeamViewer.exe -n
Auf einigen Plattformen ist jedoch auch möglich, „--n“ zu verwenden. Mehrere Parameter können zu einer Anfrage zusammengefasst werden. Beachten Sie bei Parametern die Groß-/Kleinschreibung.
Befehlszeilenaufgaben
Normalerweise läuft TeamViewer weiter, wenn Befehlszeilenparameter mitgegeben werden. Es gibt jedoch einige Aufgaben, die über Befehlszeilen ausgelöst werden können, nach denen sich TeamViewer selbst schließt.
Aufgaben:
- Gerätezuweisung
- COM API Installation
Anwendung
Folgende Optionen werden unterstützt:
Gerätezuweisung
Auf Windows wird die Zuweisung folgendermaßen gestartet:
TeamViewer.exe assign <options>
Auf macOS wird sie folgendermaßen gestartet:
Host Version:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment <options>
Vollversion:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment <options>
Für "sudo" werden Administratorenrechte benötigt, da die AssignmentData.json mit eingeschränkten Rechten vom TeamViewer Dienst geschrieben wird. Das Tool kann nur innerhalb des App-Bundles ausgeführt werden. Andernfalls findet das Tool die erforderlichen Frameworks nicht.
Falls der Wert (z. B. Gruppe) ein Leerzeichen enthält, muss der Wert zwischen " " gesetzt werden, oder jedes Leerzeichen muss auf macOS von "\" eingerahmt werden.
Verwenden Sie “-- bei Windows vor jeder Option und “-“ bei macOS vor jeder Option.
Die folgenden Optionen werden unterstützt:
Beispiele
Windows
Standardzuweisung:
TeamViewer.exe assign --api-token 12345678 --group BeliebigeGruppe
Verwendung eines Alias & Einfachen Zugriff gewähren:
TeamViewer.exe assign --api-token 12345678 --group "Some Group" --alias %COMPUTERNAME% --grant-easy-access
Verwendung eines Proxy mit Authentifizierung:
TeamViewer.exe assign --api-token 12345678 --group SomeGroup --reassign --proxy testproxy:3201 --proxy-user someuser --proxy-pw passwd
macOS
Die Beispiele sind für die Host Version. Bei der Vollversion ersetzen Sie einfach TeamViewerHost.app durch TeamViewer.app.
Standardzuweisung:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group SomeGroup
Verwendung eines Alias & Einfachen Zugriff gewähren:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group "Some Group" -alias $USER -grant-easy-access
Verwendung eines Proxy mit Authentifizierung:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group SomeGroup -reassign -proxy testproxy:3201 -proxy-user someuser -proxy-pw passwd
COM API
Auf Windows könnte eine COM API wie folgt verwendet werden:
TeamViewer.exe api <options>
Erfolgreiche Installation verfizieren
Über die Log-Datei
Öffnen Sie die TeamViewer Log-Datei aus %appdata%\TeamViewer und sehen Sie folgenden Einträge:
CommandLineTasks: initializing...
CommandLineTasks: installing COM-API
API: Installing API ...
API: ... successfully installed, calling SignalServiceParamChange ...
API: ... SignalServiceParamChange finished
CommandLineTasks: installing COM-API successful
CommandLineTasks: finished
Über Windows PowerShell
Verwenden Sie die folgenden PowerShell-Befehle:
$tv = new-object -com TeamViewer.Application
$tv.ApiVersion
Verifizieren Sie, dass die Version in den Windows PowerShell geschrieben wird, zum Beispiel:
Erfolgreiche Deinstallation verifizieren
Über die Log-Datei
Öffnen Sie die TeamViewer Log-Datei aus %appdata%\TeamViewer und sehen Sie folgende Einträge:
CommandLineTasks: initializing...
CommandLineTasks: uninstalling COM-API
API: Uninstalling API ...
API: ... successfully uninstalled, calling SignalServiceParamChange ...
API: ... SignalServiceParamChange finished
CommandLineTasks: uninstalling COM-API successful
CommandLineTasks: finished
Über Windows PowerShell
Verwenden Sie die folgenden PowerShell-Befehle:
$tv = new-object -com TeamViewer.Application
Verifizieren Sie, dass ein Fehler in den PowerShell gedruckt wird.
