Update Office for Mac by using msupdate

Applies to: Office for Mac, Office 2019 for Mac, Office 2016 for Mac

Microsoft AutoUpdate (MAU) version 3.18 and later includes the msupdate command-line tool. This can be used to start the Office for Mac update process, in addition to reporting the current AutoUpdate configuration. The tool is primarily designed for IT administrators so that they have more precise control over when updates are applied. Use the following steps to start using the tool:

  1. Open the Terminal application
  2. Enter cd /Library/Application\ Support/Microsoft/MAU2.0/Microsoft\ AutoUpdate.app/Contents/MacOS
  3. Run ./msupdate --help

The following options are displayed:

 usage: msupdate <command> [<args> ...] <modifier> 

 Commands: 
    -h | --help           Show usage information 
    -c | --config         Display current AutoUpdate configuration 
    -l | --list           List available updates for installed Microsoft applications 
    -i | --install        Download and install available updates 

 Modifiers: 
    -a | --apps <app>     Install specific application updates 
    -v | --version <app>  Only update to a specific version 
    -w | --wait <secs>    Number of seconds to wait for action to complete before returning the current state of the install command 
    -f | --format         Format output results in the specified format 
        p | plist         Property list format

Examples of how to use msupdate

  • Display the current configuration parameters for AutoUpdate: ./msupdate --config
  • Display the current configuration parameters in machine-readable format: ./msupdate --config --format plist
  • List all available updates: ./msupdate --list
  • Download and install all available updates: ./msupdate --install
  • Download and install the latest updates for Word, Excel, and PowerPoint: ./msupdate --install --apps mswd2019 xcel2019 ppt32019
  • Download and install a version-specific update for Outlook: ./msupdate --install --apps opim2019 --version 16.17.180090901

Application identifiers

The following table lists the applications for Mac supported by AutoUpdate. The identifier is used when specifying the --apps parameter. When specifying multiple applications on the command-line, separate identifiers with a space.

Application 2019 version1 2016 version2
Word mswd2019 mswd15
Excel xcel2019 xcel15
PowerPoint ppt32019 ppt315
Outlook opim2019 opim15
OneNote onmc2019 onmc15
Skype for Business msfb16 msfb16
MAU msau04 msau04
Remote Desktop msrd10 msrd10
Intune Company Portal imcp01 imcp01

1 These identifiers are used for Office 2019 for Mac, either a retail or a volume licensed version, and for Office for Mac (from an Office 365 plan) running on macOS version 10.12 (Sierra) or higher.

2 These identifiers are used for Office 2016 for Mac, either a retail or a volume licensed version, and for Office for Mac (from an Office 365 plan) running on macOS version 10.11 (El Capitan) or earlier.

Note

  • To use the 2019 version identifiers, you must be using at least MAU version 4.1 or later.
  • If you're using MAU version 4.1 or later, you can use either set of identifiers and MAU will automatically change them to the appropriate identifiers based on the criteria described in the footnotes above.
  • Identifiers are not case-sensitive.