Deploy CDM through the Command-line Interface using the MSI file

Use this method to deploy CDM with customized settings. Before you begin, you'll need to do the following:

  • Download the CloudDriveMapper.msi file from the Downloads page in Iris. Depending on your environment, the Downloads page includes an MSI file for both x64 and ARM64 devices.

  • Ensure you’ve installed Microsoft .NET Desktop Runtime 8 before deploying CDM, as the MSI file can’t install it at the beginning of the installation process due to the way its execution sequence works.

  • You’ll also need your license key, which you can copy from the CDM Dashboard in Iris.

Before deploying CDM using the CloudDriveMapper.msi file, ensure you’ve installed the prerequisites, as you can’t deploy CDM successfully without first installing these.

  1. Press Windows + S on your keyboard to open the search box.

  2. Type cmd in the search box, right-click the Command Prompt tile and select Run as administrator from the shortcut menu. The User Account Control dialog box appears.

  3. Select Yes to launch the Command Prompt console.

  4. Assuming you downloaded the CloudDriveMapper.msi file in the Downloads folder, type cd "C:\Users\UserName\Downloads" and press Enter.

If you downloaded this file in another folder, replace cd "C:\Users\UserName\Downloads" with cd "C:\path\to\folder" and press Enter. Run the following command to deploy CDM silently: msiexec /i "CloudDriveMapper.msi" /qn LICENSEKEY=your_license_key.

Customized settings

The following table lists customized settings that can be configured for CDM while deploying it via Command-line interface:

Parameter Value Description Command
/qb   Displays progress during installation. msiexec.exe /i CloudDriveMapper.msi /qb LICENSEKEY=your_license_key
/qn   Performs a silent installation. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key
/norestart   Prevents the computer from restarting automatically after installation. msiexec.exe /i CloudDriveMapper.msi /qn /norestart LICENSEKEY=your_license_key
LICENSEKEY   Enter your license key here. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key
DESKTOP_SHORTCUT 0 Prevents a desktop shortcut from being created. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key DESKTOP_SHORTCUT=0
DESKTOP_SHORTCUT 1 Creates a desktop shortcut. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key DESKTOP_SHORTCUT=1
STARTMENU_SHORTCUT 0 Prevents the Start menu shortcut from being created. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key STARTMENU_SHORTCUT=0
STARTMENU_SHORTCUT 1 Creates the Start menu shortcut. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key STARTMENU_SHORTCUT=1
STARTUP_SHORTCUT 0 Prevents CDM from running at startup msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key STARTUP_SHORTCUT=0
STARTUP_SHORTCUT 1 Runs CDM at startup msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key STARTUP_SHORTCUT=1
LAUNCHCDM 1 Launches CDM after installation and adds it to the notification area on the taskbar. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key LAUNCHCDM=1
LogLevel Debug Enables debug logging for detailed error logs. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key LogLevel=Debug
APPDIR   Installs CDM on a custom installation path. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key APPDIR=C:\Folder\cdmv3\
CLEANDATA 1 Removes CDM app data for all users during an upgrade. msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key CLEANDATA=1
MAPPINGGROUPID   Configures the specified mapping group to the computer (HKLM). msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key MAPPINGGROUPID=your_mapping_group_key
FOLDERREDIRECTIONPOLICYID   Configures the specified folder redirection policy to the computer (HKLM). msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key FOLDERREDIRECTIONPOLICYID=your_folder_redirection_key
UNINSTALLCDMLEGACY 1 Uninstalls CDM Legacy as part of the CDM (V3) installation. Applies to release 3.21 and above. msiexec.exe /i CloudDriveMapper.msi /qb LICENSEKEY=your_license_key UNINSTALLCDMLEGACY=1

Examples

  Scenario Command
1 Install CDM silently for the first time msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key
2 Install CDM silently for the first time and launch it after installation msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key LAUNCHCDM=1
3 Install CDM silently without shortcuts (recommended for VDI rollout) msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key DESKTOP_SHORTCUT=0 STARTMENU_SHORTCUT=0 STARTUP_SHORTCUT=0
4 Uninstall CDM silently msiexec.exe /x CloudDriveMapper.msi /qn
5 Install CDM silently with a custom mapping group msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key MAPPINGGROUPID= your_mapping_group_key
6 Install CDM silently with a folder redirection policy msiexec.exe /i CloudDriveMapper.msi /qn LICENSEKEY=your_license_key FOLDERREDIRECTIONPOLICYID= your_folder_redirection_key