We recommend using a specific script to deploy TeamViewer successfully on your devices.
In this article, we will show you our recommended script and explain the meaning of each parameter.
Important note: Please make sure to replace [your_xxx] with your own values.
This script processes the deployment in two steps:
start /wait MSIEXEC.EXE /i "PATH_TO_MSI_FILE\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=YOUR_CUSTOM_CONFIG_ID timeout /t 30 /nobreak "C:\Program Files (x86)\TeamViewer\TeamViewer.exe" assignment --id YOUR_ASSIGNMENT_ID
start /wait MSIEXEC.EXE /i "PATH_TO_MSI_FILE\TeamViewer_Full.msi" /qn timeout /t 30 /nobreak "C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id YOUR_ASSIGNMENT_ID
start /wait MSIEXEC.EXE /i "PATH_TO_MSI_FILE\TeamViewer_Full.msi" /qn timeout /t 30 /nobreak "C:\Program Files (x86)\TeamViewer\TeamViewer.exe" assignment --id YOUR_ASSIGNMENT_ID
We will explain here the parameters we used in our recommended scripts:
Installs the package.
Allows the silent installation.
Defines the installation path.
Note: It can also be on a network path.
Applies your module's customization.
Note: This only applies to the TeamViewer Host.
Imports TeamViewer options.
For more information, please read the following article:
Export settings for deployment
Note: The value must be a valid absolute local path or a path to a network share.
Don't use this parameter in combination with IMPORTREGFILE.
Controls the de-/activation of the Outlook plugin
true: The TeamViewer Outlook plugin is activated after installation (default)
false: The TeamViewer Outlook plugin is deactivated after the installation
Installs a virtual device driver required for the security key redirection feature that allows the use of smart cards and fido-based devices through a TeamViewer session
0: Does not install the driver (Default)
1: Installs the driver
There are additional options you can add to your command line:
For Windows:
--device-alias=[<name>]
For macOS:
-device_alias [<name>]
For Linux:
--device-alias=[<name>]
Alias for the new device in the Device list. No alias will be applied if the device is already in the contact list. The property can take the following values:
Example:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME%-%USERNAME%
Hint: If you want to use spaces, you have to put everything in "..." like in the following example:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME% Test %USERNAME%“
It will prevent the desktop shortcuts from being installed.
msiexec /i "Path\To\TeamViewer.msi" /qn ADDLOCAL=ALL REMOVE=f.DesktopShortcut
Note: If you deployed the TeamViewer Host in the past using the MSI file with the option DESKTOPSHORTCUTS=0, and now want to get rid of the shortcut, use the following command:
msiexec /i "Path\To\TeamViewer.msi" /qn REMOVE=f.DesktopShortcut
--retries
The assignment is retried in case of temporary errors. Note that there is a waiting time of 1 second between each try.
--timeout
Set the overall timeout in seconds used for all assignment tries.
Example:
TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID --retries=3 --timeout=120