Automatic Deployment of 3CX MyPhone to Terminal Server Users

Deployment of 3CX MyPhone to Terminal Server UsersGroup Policies provide the ability to deploy applications and configurations across hundreds or even thousands of computers in an organization. It is very important that procedures like these are tested thoroughly in a non-production environment before it goes live.

This article describes how to distribute 3CX MyPhone Silverlight Out of Browser on your network or to each user on a terminal server. This makes it easier for users to access 3CX MyPhone, and if you want to deploy the 3CX Desktop Components via Group Policies.

This guide has been tested using Windows 2008 R2 with Terminal Services Role and Microsoft Active Directory Services and Windows 7 clients.


  1. Connect to the host PBX and navigate to: C:\ProgramData\3CX\Data\Http\Interface\MyPhone\ClientBin
  2. Right click on the “ClientBin” folder and click on Sharing. Click Share and grant rights for “everyone” with the permission level to read.
    File Sharing
  3. Download the file “MyPhoneDeploy.bat” from here and place it in the ClientBin folder.
  4. Open the file “MyPhoneDeploy.bat” with a text editor and edit the highlighted line replacing “IPPBX” with the IP Address of the 3CX Phone System server. In this example, the IP Address of the 3CX Phone System server is so the script will look like this:
    %sllauncherlocation% /install:”\\\ClientBin\MyPhone.xap” /origin:”” /shortcut:desktop+startmenu /overwriteEdit batch file
  5. Access the Group Policy Management on the Domain controller
  6. Add an Organization Unit (OU) (in this example, Terminal Users) that specifies which domain users are allowed to receive the 3CX MyPhone installation.
    Add GPO
  7. Add and Link a new Group Policy in this Organization Unit. In this example it is called InstallMyPhone.
  8. In the Logon Properties section (User configuration ? Policies > Windows settings > Scripts), add a new Logon script pointing to the network location we created in point 2. For example: \\\ClientBin and add the file “MyPhoneDeploy.bat”
    Add Script
  9. Save all settings

To test, open a command prompt window from a Windows 7 desktop client and enter “gpupdate” to update the client’s Group Policies immediately.

Note: The log-on script is executed each time the user logs in. This causes 3CX MyPhone to be installed each time the user logs in.