This workflow guides you through upgrading an existing installation of ArcGIS Desktop software on a single machine that was originally deployed using ArcGIS PowerShell DSC module.

Prepare your deployment

Before you run the command to the module in PowerShell DSC, you’ll need to obtain the necessary files and resources and add them to your local machine.

Note: We recommend you use WMF 5.x for the best experience.

Log in to the machine on which you'll be upgrading ArcGIS Desktop. You should have PowerShell DSC and administrative authority on the machine.

Note: Remove all previous versions of the ArcGIS Module prior to performing the upgrade.

You can prepare the files either through GitHub or using the PowerShell Gallery:

Option 1: Prepare your deployment using GitHub

1. Clone this repository to your local machine.
2. Add the "ArcGIS" modules folder to your PsModulePath, or copy the modules into the default PowerShell Modules folder (e.g. C:\Program Files\WindowsPowerShell\Modules).
3. Log in to my.esri.com. Download your ArcGIS Desktop software installation files and licenses to the machine.

Option 2: Prepare your deployment using the PowerShell Gallery

1. Log in to my.esri.com. Download your ArcGIS Desktop software installation files and licenses.
2. Install the ArcGIS module using the command Install-Module ArcGIS.

Edit the configuration file

1. With a text editor, open the Desktop-SingleUse.json file that was originally used to deploy ArcGIS Desktop.
2. Update the DesktopVersion, License File path, and setup installer path to the version you will be upgrading to. For example for Desktop 10.8.1, parameter values can be the following:
   • "DesktopVersion": "10.8.1",
   • "LicenseFilePath": "C:\\authorization_files\\dt_su.prvc",
   • "Installer": { "Path": "C:\\setup_files\\ArcGIS_Desktop_1081_175110.exe" }

Upgrade your deployment

In PowerShell DSC, run the Invoke-ArcGISConfiguration cmdlet and provide the path to the configuration file as an input parameter. Mode, DebugSwitch and Credential are optional arguments.

Invoke-ArcGISConfiguration -ConfigurationParametersFile [Path to Configuration JSON File](/Esri/arcgis-powershell-dsc/wiki/Path-to-Configuration-JSON-File) -Mode [Install | InstallLicense] -Credential [Config RunAs - Optional] -DebugSwitch

or

Invoke-ArcGISConfiguration -ConfigurationParametersFile C:\Users\username\Desktop\Desktop-SingleUse.json -Mode InstallLicense