Deploying Vim Connect Desktop Agent using Group Policy - Vim

Deploying Vim Connect Desktop Agent

using Group Policy Software Package Distribution (GPO)

Vim Connect Agent is Vim’s desktop agent that enhances Electronic Medical Record (EMR) capabilities for provider organizations.

This guide provides instructions on how to distribute and deploy Vim Connect’s Desktop Agent to multiple endpoints using GPO.

Two files will be used in the process:

  1. MSI file
  2. Powershell script

MSI (Microsoft Software Installer) is used to install software on Windows operating systems. By using the Microsoft Group Policy Management Console (GPMC), it can be easily deployed to multiple machines in your domain. You will also need to use a Powershell script in order to invoke a command that installs the MSI and logs the installation process, without the need to restart the endpoint after deployment.

 

 

Getting Started

  1. Download the MSI file from https://vim.health/desktop_ecw
  2. Download the PowerShell script from http://vim.health/script
  3. Create a shared folder if one doesn’t already exist.
    You can skip steps 3-5 if you already have a shared folder on a server.
    Create a shared folder on a network folder that is accessible to all applicable machines (NETLOGON, SYSVOL, etc.).
  4. Make sure that under the “Security“ tab in the created folder’s properties, you see authenticated users and that the group has the Read and execute, List folder contents and Read permissions only:

    (Read & execute, List folder contents, Read)
  5. On the “Sharing“ tab, go to Advanced SharingPermissions and make sure “Everyone” is attached and has “Read” permissions only:
  6. Copy the MSI file and Powershell script to the shared folder.
  7. Open the PowerShell script and replace “\\Server\Share\agent-installer.msi” with the path of the MSI file you just copied. Make sure to insert the path between the double quotes, do not remove them.
  8. Replace YOUR_ORGANIZATION_KEY with your organization key (received from Vim).
  9. Your script should look similar to this example:
  10. Save the PowerShell script.

 

 

Mass deployment via GPO

  1. Open Group Policy Management Panel by running gpmc.msc
  2. Right-click on your computers’ Organizational Unit (OU) and click Create a GPO in the domain, and Link it here.
  3. Name the GPO “Vim MSI Agent Install“ or any name of choice, and click OK
  4. Right-click the created GPO, and select Edit
  5. Under Computer Configurations, go to Preferences → Control Panel Settings → Scheduled Tasks
  6. On the right pane, right-click an empty space and select New → Immediate Task (At least Windows 7)
  7. In the New Task window, set Action to Create, enter a name and description for the task.
  8. Click the Change User Or Group button
  9. Under Enter the object name to select type SYSTEM, click Check Names and then click OK
  10. Under NT AUTHORITY/System, check Run whenever user is logged on or not and Run with highest privileges

  11. You can leave the “Configure For” field with its default value:
  12. Go to the Actions tab and click New
  13. Set Action as Start a program, set Program/script as powershell, and in Add arguments(optional) type the following:
    -ExecutionPolicy Bypass -File “\\Server\Share\PowershellScript.ps1”Replace“\\Server\Share\PowershellScript.ps1” with the path where you saved the powershell script and make sure to insert the path between the double quotes.

    Click OK when done.
  14. Run CMD and type gpupdate /force to force group policy update on a workstation, or wait for the next group policy update, which normally runs in a 90-120 minutes interval.
  15. In order to verify that the deployment is successful, look for the “Vim Connect” app in the Start menu

 

 

Questions? Contact your Vim representative or reach us at [email protected]