Dieser Artikel richtet sich an alle Kunden mit einem Corporate oder Tensor Plan.
Dieser Artikel bezieht sich auf die TeamViewer Version 13.2 oder neuer.
Unterstütze Windows Versionen: Win 7, Win 8, Win 10.
In diesem Artikel wird erläutert, wie Sie TeamViewer Host und die TeamViewer Vollversion in einem Mass Deployment Szenario unter Windows ausrollen.
Installation
Für Windows bietet TeamViewer zwei MSI-Installer an:
- TeamViewer_Host.msi: Damit wird das (personalisierte) Host Modul von TeamViewer installiert.
- TeamViewer_Full.msi: Damit wird die TeamViewer Vollversion installiert.
Standard Host Modul
Um TeamViewer in einem Mass Deployment Szenario ohne Benutzerinteraktion zu installieren, müssen Sie den folgenden Befehl in Ihrem Skript direkt über die Befehlszeile oder in Ihrer Bereitstellungslösung verwenden:
- msiexec.exe /i "<Pfad zu Ihrer TeamViewer_Host.msi>" /qn
- Die Eigenschaft /i gibt an, dass Sie eine Installation durchführen möchten.
- Die Eigenschaft /qn erzwingt eine automatische Installation. Dies bedeutet, dass während der Installation keine Benutzerinteraktion erforderlich ist.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn
Die Installation von TeamViewer erfordert Administratorrechte. Es sind weitere Eigenschaften für den Windows Installer verfügbar, um die Installation zu steuern. Geben Sie einfach Folgendes in die Eingabeaufforderung ein: msiexec.exe /?
Personalisiertes Host Modul
Wenn Sie einen personalisierten Host ohne Benutzerinteraktion installieren möchten, müssen Sie die folgenden Schritte ausführen:
1) Erstellen Sie ein neues personalisisertes Modul oder öffnen Sie die Bearbeitung eines bestehenden Moduls:
💡 So erstellen Sie Ihren personalisierten Host: Besuchen Sie die Seite Anpassen & Ausrollen, um Ihre Anpassungen in der TeamViewer Management Console vorzunehmen. Nachdem Sie die Anpassungen Ihres Host Moduls vorgenommen haben, wird eine Konfigurations-ID generiert. Sie finden diese, indem Sie anschließend beim relevanten Modul auf Bearbeiten klicken.
2) Kopieren Sie die Konfigurations-ID Ihres personalisierten Host Moduls.
3) Öffnen Sie die Windows-Eingabeaufforderung (CMD) mit Administratorrechten oder führen Sie die MSI über ein Skript (Batch usw.) aus.
💡 Die Eingabeaufforderung muss als Administrator gestartet sein. Wenn Sie die MSI innerhalb eines Skripts ausführen, muss das Skript auch mit Administratorrechten ausgeführt werden.
4) Geben Sie Folgendes in die Eingabeaufforderung ein: msiexec.exe /i "Pfad\zur\TeamViewer_Host.msi>" /qn CUSTOMCONFIGID=<IHRE_KONFIGURATIONSID>
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=<IHRE_KONFIGURATIONSID>
5) Im Folgenden finden Sie ein Beispiel dafür, was erforderlich ist, um das Gerät zuzuweisen und die persönlichen Anpassungen vorzunehmen.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=IHRIDCCODE
timeout /t 10 /nobreak
Pfad\Zur\TeamViewer.exe assign --api-token=IHRTOKEN --grant-easy-access
Vollversion
Um TeamViewer in einem Mass Deployment Szenario ohne Benutzerinteraktion zu installieren, müssen Sie die folgenden Schritte ausführen:
1) Öffnen Sie die Windows-Eingabeaufforderung (CMD) mit Administratorrechten oder führen Sie die MSI über ein Skript (Batch usw.) aus.
💡 Die Eingabeaufforderung muss als Administrator gestartet sein. Wenn Sie die MSI innerhalb eines Skripts ausführen, muss das Skript auch mit Administratorrechten ausgeführt werden.
2) Geben Sie Folgendes in die Einabeaufforderung ein: msiexec.exe /i "Pfad\Zur\TeamViewer_Full.msi" /qn
Die Eigenschaft /i gibt an, dass Sie eine Installation durchführen möchten.
Die Eigenschaft /qn erzwingt eine automatische Installation. Dies bedeutet, dass während der Installation keine Benutzerinteraktion erforderlich ist.
msiexec.exe /i "Pfad\Zur\TeamViewer_Full.msi" /qn
💡 Hilfe für den Windows Installer: Um die Installation zu steuern, sind weitere Eigenschaften für den Windows Installer verfügbar. Geben Sie einfach Folgendes in die Eingabeaufforderung ein: msiexec.exe /?
Personalisierte Vollversion
Erfahren Sie in diesem Artikel mehr darüber.
Konfiguration der Installation
TeamViewer Optionen übernehmen (empfohlen)
1) Exportieren Sie eine Options-Datei von einem TeamViewer Client. Seit der Version 15.4 erhalten Sie eine *.tvopt-Datei. In vorherigen Versionen wurde eine *.reg-Datei erstellt. Für den Import können Sie beide Versionen verwenden, wir empfehlen jedoch die Nutzung der *.tvopt-Datei.
💡 So erhalten Sie die Optionsdatei:
Installieren Sie TeamViewer auf einem einzelnen Computer und konfigurieren Sie die Optionen, wie Sie diese benötigen.
Im Optionen-Dialog unter Extras --> Optionen --> Erweitert können Sie auf Export... klicken um die *.tvopt-Datei zu exportieren.
2) Fügen Sie die Eigenschaft SETTINGSFILE="ABSOLUTE_PATH/TO/SETTINGSFILE" zu Ihrer Kommandozeile hinzu, wenn Sie den TeamViewer_Host.msi oder TeamViewer_Full.msi installieren. Der angegebene Pfad muss entweder zu einer lokal gespeicherten Datei führen oder zu einem Pfad in Ihrem Netzwerk.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn SETTINGSFILE="C:/my_settingsfile.tvopt"
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn SETTINGSFILE="\\share\my_settingsfile.tvopt"
TeamViewer Einstellungen übernehmen (veraltet)
Der Parameter IMPORTREGFILE ist seit Version 15.4 veraltet. Er kann akutell noch mit der Version 15.3 oder niedriger verwendet werden, wird aber mit einer der kommenden Version entfernt werden. Wir empfehlen daher, bereits jetzt den Parameter SETTINGSFILE zu verwenden. Wenn Sie dennoch über die veraltete Methode einige vordefinierte TeamViewer Einstellungen für Ihre Installation bereitstellen möchten, gehen Sie wie folgt vor:
1) Legen Sie die Optionsdatei "TeamViewer_Settings.reg" (hierbei ist es zwingend erfoderlich, dass die Datei so benannt wird) im selben Verzeichnis wie die MSI-Datei ab.
💡 So erhalten Sie die Optionsdatei:
Installieren Sie TeamViewer auf einem einzelnen Computer und konfigurieren Sie ihn nach Ihren Bedürfnissen. In den erweiterten Einstellungen Ihres TeamViewers unter Extras --> Optionen --> Erweitert haben Sie die Möglichkeit, die Optionen in eine *.reg Datei zu exportieren. Benennen Sie diese *reg. Datei als "TeamViewer_Settings.reg".
2) Fügen Sie Ihrem Befehl die Eigenschaft IMPORTREGFILE=1 hinzu, wenn Sie TeamViewer_Host.msi (Version 13.2 oder höher) oder TeamViewer_Full.msi (Version 14.0 oder höher) installieren. 0 ist der Standardwert für IMPORTREGFILE und importiert die Einstellungen nicht.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn IMPORTREGFILE=1
Den Host oder die Vollversion einem Account zuweisen
Beim Ausrollen von TeamViewer kann es hilfreich sein, die neue TeamViewer Installation einem vorhandenen Konto zuzuweisen. Sie können dies folgendermaßen tun:
1) Installieren Sie TeamViewer via MSI
2) Warten Sie nach der Installation bis TeamViewer online ist
3) Rufen Sie die TeamViewer.exe auf und fügen Sie Ihr API-Token und Ihre Zuweisungsoptionen an den Commandline Task "assign" an:
msiexec.exe /i "Pfad\Zum\TeamViewer_Host.msi" /qn
timeout /t 10 /nobreak
Pfad\Zur\TeamViewer.exe assign --api-token=IHRTOKEN --group IHREGRUPPE
Zusammenfassung der MSI Konfigurationseigenschaften
Hier die Zeile, um einfacher zu kopieren:
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" ENABLEOUTLOOKPLUGIN="false"
Update von TeamViewer
TeamViewer_Host.msi
Wenn Sie den TeamViewer Host installieren möchten und bereits eine TeamViewer Version installiert haben, müssen Sie sicherstellen, dass das Update unterstützt wird. In der folgenden Tabelle wird erläutert, wann eine Installation möglich ist und wann Sie Ihre vorherige Version zuerst deinstallieren müssen:
TeamViewer.msi
Wenn Sie die TeamViewer Vollversion installieren möchten und bereits eine TeamViewer Version installiert haben, müssen Sie beachten, dass die Datei TeamViewer_Full.msi (TV 14.0 oder höher) nicht mit einer zuvor installierten Version von TeamViewer kompatibel ist:
Das automatische Update in TeamViewer ist nicht mehr verfügbar, wenn Sie die MSI-Datei für die Installation verwenden. Es muss erneut mit dem Windows Installer aktualisiert werden.
TeamViewer deinstallieren
Sie können Ihren TeamViewer bei Bedarf deinstallieren, wenn Sie zum Beispiel von einem Host Modul zur Vollversion wechseln möchten:
- Verwenden Sie genau denselben Windows MSI Installer, den Sie auch für die Installation verwendet haben
- Machen Sie von der üblichen Deinstallation über die Systemsteuerung Gebrauch
Deinstallation über den Windows Installer
Sie können den Deinstallationsbefehl im Windows MSI Installer (/uninstall oder /x) verwenden. Stellen Sie sicher, dass Sie das richtige MSI (Vollversion oder Host) für die Deinstallation verwenden.
msiexec.exe /uninstall "Pfad\Zur\TeamViewer_Host.msi"
💡 Zum Starten der Befehlszeile sind Administratorrechte erforderlich.
Zuweisung
Einführung
Sie können einen TeamViewer Host oder die Vollversion so konfigurieren, dass sie einem TeamViewer Account zugewiesen werden. Sie können dies während des Installationsvorgangs tun.
Diese Beschreibung gilt für TeamViewer 14.x (oder höher) und zusätzlich für den Host in Version 13.2.
Sie haben zwei Möglichkeiten, ein Gerät einem TeamViewer Konto zuzuweisen:
- (Empfohlen) Mit der TeamViewer Programmdatei nach einer Installation (TeamViewer.exe)
- Mit dem Windows MSI Installer (TeamViewer_Full.msi oder TeamViewer_Host.msi)
💡 Wenn Sie eine ältere Version von TeamViewer verwenden, müssen Sie die Zuweisung mit dem Zuweisungstool durchführen. Weitere Informationen dazu finden Sie hier.
Wie wird die Zuweisung durchgeführt?
Um die Zuweisung durchzuführen, benötigen Sie Folgendes:
1) (erforderlich) ein gültiges API Token
2) (optional) Zuweisungsoptionen, um genauer zu definieren, wie das Gerät zugewiesen werden soll
💡 Ein API Token kann auf zwei Arten abgerufen werden:
1. In Ihrer personalisierten Host Konfiguration oder der personalisierten Vollversion, wenn Sie bei der Erstellung die Option Zuweisung zum Konto mit Hilfe des Zuweisungstools erlauben aktiviert haben.
2. Sie können ein Skript-Token in Ihrem Benutzerprofil erstellen --> Apps. Dieses Skript-Token benötigt mindestens die folgenden Berechtigungen:
- Gruppenverwaltung → Gruppen anzeigen, erstellen, bearbeiten und teilen
- Computer & Kontakte → Einträge anzeigen, hinzufügen, bearbeiten und löschen
Zuweisung mit der TeamViewer Programmdatei (empfohlen)
Sie sollten die Zuweisung vornehmen, nachdem der TeamViewer Host oder die Vollversion installiert wurde. Es ist wichtig, dass TeamViewer auf dem Gerät gestartet ist, das Sie zuweisen möchten.
Rufen Sie TeamViewer.exe (oder nur TeamViewer) mit dem Befehl assign auf, gefolgt von der Eigenschaft --api-token und Ihren Zuweisungsoptionen:
TeamViewer.exe assign --api-token <APITOKEN> [--group-id <GROUP_ID> --grant-easy-access --reassign --proxy <YOUR_PROXY> --proxy-user <YOUR_PROXY_USER> --proxy-pw <PASSWORD>]
Zuweisung mit dem Windows MSI Installer
Sie können die Zuweisung auch während des Installationsvorgangs vorzunehmen. Dazu müssen Sie lediglich Ihren MSI Installer ausführen und die Eigenschaft APITOKEN sowie optional die Eigenschaft ASSIGNMENTOPTIONS hinzufügen.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> [ASSIGNMENTOPTIONS="<YOUR OPTIONAL SETTINGS>"]
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> [ASSIGNMENTOPTIONS="<YOUR OPTIONAL SETTINGS>"]
Zuweisungsoptionen
--alias [<name>]
Alias für das neue Gerät in der Computer & Kontakte Liste. Befindet sich das Gerät bereits in der Kontakteliste, wird kein Alias angewendet. Der Parameter kann die folgenden Werte annehmen:
1) --alias (ohne Wert) → Alias des Geräts ist die TeamViewer ID
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias --group MyGroup"
2) --alias Hallo → Alias des Geräts wird "Hallo" sein
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias Hallo --group MyGroup"
3) Alias Parameter nicht angegeben → Alias des Geräts wird %computername% sein
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group MyGroup"
4) --alias %systemvariable% → Alias wird die verwendete Systemvariable sein, z.B. %username%
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias %systemvariable% --group MyGroup"
--grant-easy-access
Wenn Sie diese Option festlegen, wird nach der Zuweisung einfacher Zugriff gewährt (wie bei der Option "Einfachen Zugriff gewähren" im TeamViewer Hauptfenster).
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--grant-easy-access --group MyGroup"
--reassign
Weist das Gerät dem Konto zu, auch wenn das Gerät bereits einem anderen Konto zugewiesen ist.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--reassign --group MyGroup"
--group <name>
Name der Gruppe, zu der das Gerät hinzugefügt wird. Wenn die Gruppe nicht existiert, wird sie automatisch erstellt. Wenn das Gerät bereits in der Computer & Kontakte Liste in einer anderen Gruppe vorhanden ist, wird es nicht in die Gruppe verschoben. Wenn Sie jedoch den Parameter "--reassign" verwenden, wird sich auch die Gruppe ändern.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group MyGroup"
💡 Nicht erforderlich, wenn ein personalisierter Host verwendet wird, da in der benutzerdefinierten Konfiguration bereits eine Standardgruppe definiert ist.
--group-id <ID>
Diese Option ist eine Alternative zur Verwendung des --group Parameters, wenn die Gruppen-ID bekannt ist. Dies kann in sehr großen Kundenumgebungen nützlich sein, da es den Zuweisungsprozess beschleunigt. In der Regel ist die Verwendung von --group ausreichend.
📌 Hinweis: Der ID muss ein buchstäbliches "g" vorangestellt werden.
Sie finden die Gruppen-ID, wenn Sie sich in der Management Console anmelden, auf die Gruppe klicken und die URL überprüfen. Am Ende der URL finden Sie "g/12345678".
📌 Hinweis: Bitte entfernen Sie den "/", um Ihre Gruppen-ID zu erhalten.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group-id g123"
--proxy <name>:<port>
URL Ihres Proxys (nur für die Zuweisung) im Format <Name>: <Port>, z. B. --proxy yourproxy: 3201
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"
⚠ URL ohne http://
--proxy-user <name>
Benutzername, der für die Authentifizierung gegenüber dem Proxy verwendet wird (nur für die Zuweisung).
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"
--proxy-pw <password>
Passwort, das für die Authentifizierung gegenüber dem Proxy verwendet wird (nur für die Zuweisung).
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"
--proxy-pw-base64 <encoded_password>
Entspricht --proxy-pw, das Kennwort muss jedoch als Base64-codierte Zeichenfolge eingegeben werden. Nützlich für Passwörter mit Sonderzeichen.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw-base64 bXlwYXNz --group MyGroup"
Hilfe für Zuweisungsoptionen
- Wenn Sie Parameterwerte mit Leerzeichen haben (z.B. für den Gruppennamen), verwenden Sie zwei doppelte Anführungszeichen (keine einfachen doppelten Anführungszeichen!), um sie zu rahmen.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<IHR_APITOKEN> ASSIGNMENTOPTIONS="--group ""Test group"""
- Bei Zuweisungsparametern wird die Groß- und Kleinschreibung nicht berücksichtigt (seit Version 14.0).
- In den ASSIGNMENTOPTIONS können Proxy-Einstellungen für die Zuweisung festgelegt werden. Es gibt zusätzliche Proxy-Einstellungen für die TeamViewer Verbindung selbst (wie in den TeamViewer Optionen definiert). Diese müssen außerhalb der ASSIGNMENTOPTIONS eingestellt werden.
- Sie können Ihren Befehlen auch Umgebungsvariablen für die Installation/Zuweisung hinzufügen, um dynamische Werte hinzuzufügen, z.B. für den Alias. Sie können Umgebungsvariablen nutzen, indem Sie %% verwenden.
msiexec.exe /i "Pfad\Zur\TeamViewer_Host.msi" /qn APITOKEN=<IHR_APITOKEN> ASSIGNMENTOPTIONS="--alias %COMPUTERNAME%"
