Knowledge Base

Back to support overview

You can deploy the TeamViewer Host (version 13.2 or above) and the TeamViewer full version (version 14 and above) via GPO in combination with MSI and parameters.

Please remember that you must follow the steps shown in the following article when working in Orca: Mass deployment on Windows - Overview

📌Note: Please be aware that deploying MST via GPO might work but is not a supported method.

This article applies to all TeamViewer customers with a Corporate or Tensor license.

Requirements

To be able to deploy via GPO, you need to create the required .MST file. To do this, you must install Microsoft Orca.

Microsoft Orca can be found here: Orca.exe - Win32 apps | Microsoft Learn

It is recommended to download the ISO file, as it allows you to either extract and install or install orca.msi after opening the ISO.

How to deploy TeamViewer via GPO

Steps to be done in Orca

  1. Once installed, open Microsoft Orca and load the TeamViewer_Host.msi. Click Transform ➜ New Transform
  2. Click on the Property tab.
  3. Double-click the properties to adjust each. Right-click and select add row to add more parameters. All necessary parameters must be added (e.g. CUSTOMCONFIGID, APITOKEN, ASSIGNMENTOPTIONS, etc.).
  4. Once all parameters are added, navigate to the Transform pane (at the top) and generate the transformation.

Important: for more information about parameters, see here: Assignment options

Adding the MST file to the GPO config

When adding the MSI package to the GPO please choose the MST file by following the steps below;

  1. Open the group policy object editor.
  2. Expand Computer Configuration ➜ Software Settings.
  3. From the Right-Click menu, select Software Installation ➜ New ➜ Package...
  4. Point to the TeamViewer_Host.msi file.
    • 📌Note: The path to the TeamViewer_Host.msi and MST file must not be local or through a network drive. Rather, the path should be through a network share accessible from everywhere in your network to which everyone has at least Read permissions.
  5. Under Deployment Method, choose Advanced. If you choose another option, you won't be able to apply the MST file you created.
  6. Add a name for the package for easy identification (e.g. TeamViewer Host).
  7. Switch to the Modifications tab and click Add.
  8. Point to the correlating MST file. Again, it is very important to use a UNC to the file (to the network share), rather than a local/network drive path.

 Once completed, deployment is ready.