Chat now with support
Chat with Support

Metalogix Archive Manager for Exchange 8.3 - Outlook Addin Installation Guide

Deploying Archive Manager Outlook Addin Installer using Group Policy

This part describes how to use Group Policy to automatically distribute Archive Manager Outlook Add-in Installers to users. You can use Group Policy to distribute the setups by using the following methods:

·Assigning Add-in Installer.msi (A)

·Publishing Add-in Installer.msi or Add-in Installer.exe (B)



·Assigning Archive Manager Outlook Add-in Installers to client computers is not supported.

·Add-in Installer.msi installs only Add-in setup (Add-in Installer.msi) without any prerequisites checking. The prerequisites must be checked and installed manually before the Add-in setup is launched. Missing prerequisite on the client’s computer may interrupt the Add-in Installer.msi distribution via GPO or Add-in functionality errors in Outlook. See the Troubleshooting section.


Create a Distribution Point

To publish or assign an Archive Manager Outlook Add-in Installer, you must create a distribution point on the publishing server:

·Log on to the server computer as an administrator.

·Create a shared network folder which will contain the Archive Manager Outlook Add-in Installer that you want to distribute.

·Set permissions on the share to allow access to the distribution package (Everyone should have read access).




·Copy the Archive Manager Outlook Add-in Installer to the distribution point.

Create a Group Policy Object

To create a Group Policy object (GPO) in MS Windows Server 2012 / 2012 R2 / 2016 / 2019 with which to distribute the software package:

1.Start Group Policy Management.

2.In the console tree, expand your domain.

3.Expand context menu on Group Policy Object, and then click New.


4.Create a new policy (for example: Deploy_Add-in_Setup).


5.Set security filtering for this policy to select groups or users to which you want to apply this policy.



NOTE: The deafult settings automatically includes Authentificated User as default group, which allows to apply this policy for all valid domain users.

6.Link newly created policy to your domain (right-click your domain and select Link an Existing GPO...)


7.Select the GPO you created.



NOTE: It is not required to link a GPO for the whole the domain; you may create your own organization unit (OU) and apply the software distribution only for this OU.

8.Expand context menu on newly created policy, and click on Edit to distribute Archive Manager Outlook Add-in Installers by this policy.



NOTE: This opens a Group policy Management Editor.


Assigning Addin Installer.msi

You can assign an Add-in Installer.msi distribution to users. If you assign the program to a user, it is installed when the user logs on to the computer. When the user first runs the program, the installation is finalized.  Combination of custom ADM template, with assigning Add-in Installer.msi method is recommended for users with limited privileges (see also the part Change archive-retrieve server names by ADM template). When you use assigning software method to install Archive Manager Outlook Add-in Installer to a user's system, the installation runs with elevated privileges (e.g. system permissions) that bypass the user's limited permissions.

MS Windows Server 2012 / 2012 R2 / 2016 / 2019

To assign a program to users that are logging on to one of these workstations:

1.Expand context menu on newly created policy, and click edit to open Group Policy Management Editor.

2.Under User Configuration, expand Software Settings.

3.Right-click Software installation, point to New, and then click Package.


4.In the Open dialog box, type the full Universal Naming Convention (UNC) path to the shared folder (distribution point, described above) that contains the Archive Manager Outlook Add-in Installer MSI package. For example, \\file server\share\Archive Manager_Add-in Installer.msi.

5.Select Add-in setup (Add-in Installer.msi) and click Open. Do not browse to the location. Ensure that you use the UNC path to the shared folder.


6.Click Assigned, and then click OK. The package is listed in the right pane of the Group Policy window.


7.Click on assigned package, and then click Properties. From the Deployment type section select Assigned and from the Deployment options section select Install this application at logon.


8.Close the Group Policy Management Editor. When selected user log on the client computer, the managed software package will be automatically installed.

9.Verify that the Archive Manager Outlook Add-in was installed correctly by inspecting the Add or Remove Programs on client computers.


NOTE: Check event viewer for install status, look for similar descriptions: “Changes to software installation settings were applied successfully.” Or “The assignment of application Archive Manager Outlook Add-in from policy Archive Manager Add-in succeeded.”

10.Open Microsoft Outlook. from the Archive Manager menu select Options. Type the name of the archive and retrieve servers there.


NOTE: There is another possibility to set archive and retrieve server name for Archive Manager Add-in, using GPO administrative template (ADM template). By using the Administrative Template sections of the GPO you can deploy modifications and user (called HKEY_CURRENT_USER in the registry) portions of the Registry of computers that are influenced by the GPO. These changes will be affected, when the user logs on to computer. For more details, see the part Change archive-retrieve server names by ADM template.



NOTE: After the changes were applied, open Archive Manager menu\Info and click reconnect. For most common errors see the Troubleshooting part.


Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating