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.

This article applies to Corporate and Tensor license holders who want to deploy TeamViewer (14 or newer) on their Windows devices.

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>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.


Allows the silent installation.


Defines the installation path.

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


Applies your module's customization.


Allows the Account Assignment.


Applies the settings you have exported.

For more information, please read the following article:

📄 Export settings for Host deployment


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


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"

  • The ID must be prepended with a literal "g".
  • Please remove the "/" in order to get your group-id.

Therefore, according to the example in the image above, your group-id is g123456789.