Knowledge Base

To deploy TeamViewer successfully on your devices, we recommend using specific scripts.

In this article, we will show you two different scripts we recommend using and explain the meaning of each parameter.

Recommended scripts

🚨 Important note: Please make sure to replace xxxxxx with the values that you kept safe after Deploy TeamViewer on Windows - 2/6

Script #1

This script processes the deployment all at once.

msiexec.exe /i "Path_to\TeamViewer_Host.msi" /qn APITOKEN=xxxxxx CUSTOMCONFIGID=xxxxxx ASSIGNMENTOPTIONS="--alias %ComputerName% --grant-easy-access --group-id gxxxxxx"

Script #2

This script processes the deployment in two steps:

1. Installation of the package
2. Account assignment

msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=xxxxxx
ping -n 31 127.0.0.1>nul
& "Path\To\TeamViewer.exe" assign --api-token xxxxxx --grant-easy-access --group-id gxxxxxx

Main parameters

We will explain here the parameters we used in our recommended scripts:

msiexec.exe /i

Installs the package.

/qn

Allows the silent installation.

"Path_to\TeamViewer_Host.msi"

Defines the installation path.

📌Note: It can also be on a network path.

CUSTOMCONFIGID=xxxxxx

Applies your module's customization.

APITOKEN=xxxxxx  

Allows the Account Assignment.

SETTINGSFILE="YOURPATH\yourfilename.tvopt"

Applies the settings you have exported.

For more information, please read the following article:

📄 Export settings for Host deployment

ASSIGNMENTOPTIONS=

A variety of options can be added to your deployment. Please see Assignment options - 5/6 for more information.

--grant-easy-access

If you set this option, easy access is granted after the assignment (same as the "Grant easy access" option in the Security tab of the TeamViewer (Classic) options).

--group-id <ID>

This option is an alternative to using the --group parameter if the group's ID is known. This might be useful in very large customer environments as it speeds up the assignment process. Usually, using --group is sufficient.

📌Note: You can find the group-id when logging into the Management Console, clicking on the desired group, and checking the URL. At the end of the URL, you will find "g/123456789"