Upgrade from Microsoft Remote Desktop for Mac 8 to 10 using Munki

Microsoft Remote Desktop 10

The upgrade of Microsoft Remote Desktop (MRD) from version 8 to version 10 also involves a change in delivery for many MacAdmins from the Mac App Store (MAS) to a standard package installer.

Since a few extra considerations are involved I decided to share how I accomplished it using Munki. Read on if you are interested in the details.


First some history (feel free to skip ahead if you just want the technical details):

In late 2017 Microsoft quietly released Remote Desktop 10 in the Mac App Store as a separate listing from Remote Desktop 8 which also remained available for installation. It wasn’t immediately clear why they were listed separately instead of 10 simply replacing 8 however.

Microsoft Remote Desktop 8

In January of this year we got an update from Microsoft’s David Belanger in the MacAdmins Slack who shared some details of the roadmap, most importantly this piece of information: “…there is no active development on RDC8 and it will eventually be removed from the Store once the critical feedback [of version 10] has been addressed.”

If nothing else this was a clear signal that MacAdmins, many of whom were just now becoming aware that version 10 existed, needed to start testing it right away. True to Belanger’s word, only a single update has been released since that time, 8.0.43 to 8.0.44, which added messaging about version 8’s impending demise.

Starting with version 10.1.6 in March, to the delight of many MacAdmins, Microsoft made Remote Desktop available as a package for standalone installation not dependent on the MAS. It was added to the MacAdmins.software website and support was added for keeping it up-to-date with Microsoft AutoUpdate.

I wasn’t able to immediately update our computers here because of a couple bugs I ran into on the two primary third-party services we use MRD with. Microsoft’s Elton Saul was great to work with in confirming these bugs and keeping me updated on the fixes which arrived in 10.2.2 that released yesterday. With those bugs fixes it is time to roll it out.


The first consideration when upgrading is that version 10 will not overwrite version 8. If either version of the installer, MAS or PKG, detects version 8 on disk it will create a new folder and place version 10 inside of it at:
/Applications/Microsoft Remote Desktop/Microsoft Remote Desktop.app

This is helpful if your employees might need to use both versions for a while. In my case we’re making a full switchover so before we install version 10 we need to remove version 8 and this is easily accomplished with a Munki preinstall script:

#!/bin/bash

/bin/rm -rf /Applications/Microsoft\ Remote\ Desktop.app/

I’ll only need to include this in the PkgInfo for a version or two until I’m sure everyone has made the upgrade. I’ve already been distributing version 8 through Munki so importing version 10 as just a newer version of the existing application makes this upgrade very easy.

An alternative if you want to keep version 8 around for a while but install version 10 at the standard location on disk would be to rename MRD8 before installing MRD10 with a similar preinstall script.

The second consideration is that there isn’t an automated way to import bookmarks from version 8 or to programmatically create new ones in version 10, but these are both options that Microsoft is working on. Thankfully version 10 will allow the manual import of version 8 bookmarks even if the old application is no longer on disk as in my example.

To address this I have not marked version 10 as an Unattended Install so that users will have to manually approve the upgrade in Managed Software Center. I’ve also provided staff with some extra instruction on how to import their version 8 bookmarks when they launch version 10 for the first time.

Removing version 8 first ensures that any existing Dock icons or shortcuts will launch version 10 post upgrade and hopefully the bookmark import instructions will prevent any confusion after the upgrade. I’m anticipating a smooth rollout over the next week.

UPDATE 12/13/18:

Version 10.2.4 released today includes: “An option to import from Microsoft Remote Desktop 8 now appears in the Connection Center if it is empty.” This is a welcome addition that will make this transition easier for anyone going forward.

In even bigger news this release also includes unannounced scripting support for creating bookmarks programmatically! Microsoft’s Gieta Laksmana has been sharing details and examples in Slack.

(Version 10.2.5 is just a small bug fix for the package installer only and won’t be in the MAS.)

Leave a Reply

Your email address will not be published.