Skip To Content

Deploy across the enterprise

Large organizations may not want to deploy the ArcGIS Maps for Office add-in to each computer on their network individually. To support large-scale deployments, ArcGIS Maps for Office includes options for installation from the command line. Automated deployment solutions can be built using these command line options. For example, if your organization wants to use ArcGIS Enterprise as the default ArcGIS connection, you can set the CONNECT_TO parameter to your ArcGIS Enterprise portal URL. If you use this setting when you deploy across the organization, all computers will use your ArcGIS Enterprise.

Install required software

Before you begin, be sure that the required software is properly installed and configured on each system. Although you can use the FORCEINSTALLPREREQ parameter (set to true) to check for software prerequisites and automatically install missing software, some enterprise systems mandate that required software be installed separately.

ArcGIS Maps for Office requires the following software:

  • Microsoft Office 2010, 2013, or 2016*

    *Important: With Microsoft Office 2016 version 16.0.6326.1010, ArcGIS Maps for Office backstage controls do not function as designed. All other Microsoft Office 2016 versions are supported

  • Microsoft Windows. Supported versions are as follows:
    • Windows 7 (32 bit and 64 bit)
    • Windows 8 (32 bit and 64 bit)
    • Windows 8.1 (32 bit and 64 bit)
    • Windows 10 (32 bit and 64 bit)
    • Windows Server 2008 R2
    • Windows Server 2012
    • Windows Server 2012 R2
  • Microsoft .NET Framework 4.5.2 or later
  • Microsoft Visual Studio 2010 Tools for Office runtime
  • Microsoft Visual C++ 2015 runtime assemblies

Install ArcGIS Maps for Office

To install ArcGIS Maps for Office from the command line, do the following:

  1. Open an administrator command line terminal.
    • For Windows versions earlier than Windows 8, click Start > Run, type cmd, and click OK.
    • For Windows 8, press the Windows key on the keyboard and type cmd. Right-click cmd.exe and choose Run as administrator.
  2. Navigate to the folder containing the ArcGIS Maps for Office executable file and type the following command:

    The following code is broken onto separate lines for clarity only. Type the code into your command window on a single line.

    /msicl "CONNECT_TO=" 
    /msicl "FORCEINSTALLPREREQ=true" 
    /msicl "ESRIMAPSWEBROOT="  
    /msicl "ESRIMAPSWEBPROXY=/proxy"
    /msicl "ENABLEUSERFEEDBACK=true"
  3. Press Enter.

The command shown above includes all the available configuration options. Some parameters are mandatory; others are optional. If you do not want to change an optional default configuration, you do not need to include it in your command.

Available options are the following:

  • CONNECT_TO—This parameter is mandatory. The value for this parameter is either, the URL to your ArcGIS Online organization, or the URL to your ArcGIS Enterprise portal instance. Change this value to point to the appropriate location.
  • FALLBACKTOCLOUDRESOURCES—This parameter is mandatory. If your organization uses ArcGIS Enterprise, the resources must be installed on the same system as the portal. Setting this parameter to true allows users to work with ArcGIS Maps for Office if the resources are not available on your portal and the user has Internet connectivity. The default value is false.
  • FORCEINSTALLPREREQ—The ArcGIS Maps for Office installer checks whether required software is installed on the system. If this parameter is set to true, prerequisites are installed before installing ArcGIS Maps for Office. If set to false, the installation process aborts if required software is not found. The default value is false.
  • CHECKFORSOFTWAREUPGRADE—If set to true, the installer verifies whether a new version of ArcGIS Maps for Office is available. If you don't want to check for upgrades, set this value to false. The default value is true.
  • FORCEUSERAPPCONFIGUPDATE—When you use ArcGIS Maps for Office for the first time, custom configuration files are written to your roaming directory. These files hold configurations for custom location types, ArcGIS connection settings, and more. These settings are left in place during upgrades to new versions of ArcGIS Maps for Office. To reset these files to the default settings (or the settings specified during the installation), set this parameter to true. By default, this parameter is set to false for silent installations.
  • ESRIMAPSWEBROOT—This parameter specifies the location of the JavaScript files used by ArcGIS Maps for Office. By default, this is set to when the ArcGIS connection is either or the URL of your ArcGIS Online organization.

    If your organization uses Portal for ArcGIS 10.3 through 10.4.1 or ArcGIS Enterprise 10.5 or later , the default value is the location on the portal machine where required JavaScript files are written during installation of the ArcGIS Maps for Office resources (see Work with ArcGIS Enterprise).

    If your organization uses Portal for ArcGIS10.2.2 or earlier, or if your portal is behind a firewall, you may need to host the files on a server on your local network. Follow the instructions to configure ArcGIS Maps for Office in a disconnected environment and use this parameter to point to the files on your local network.

    If your ArcGIS connection is either, the URL to your ArcGIS Online organization, or the URL to a ArcGIS Enterprise instance version 10.3 or later, it is recommended that you use the default parameter value (do not specify this parameter in your command).

  • ESRIMAPSWEBPROXY—Older browsers sometimes need to use a proxy to avoid errors related to Cross Origin Resource Sharing (CORS). Normally, this proxy is hosted by Esri on ArcGIS Online or ArcGIS Enterprise and, in most cases, you do not need to change the default value. The only time this value should be changed is if ArcGIS Maps for Office will be connecting to ArcGIS Enterprise and you want to host the proxy in a custom location. In that case, use this option to point ArcGIS Maps for Office to your custom proxy location.
  • ENABLEUSERFEEDBACK—If set to true, this enables the Esri User Experience Improvement program, allowing the program to send anonymous information to Esri . By default, this parameter is set to true; to disable user feedback, set this parameter to false.