Attention Mac OS
Get an alert for incoming phone and FaceTime calls, new texts, email messages, and calendar events through vibration on iPhone or a quick LED light flash on iPhone, iPad, and iPod touch. If you’re on a Mac, it can flash the screen when an app needs your attention. Beautiful, subtle animations throughout macOS convey status, provide feedback, and help users visualize the results of their actions. For example, when the user duplicates a TextEdit document, the copy springs forth from the original to illustrate that it's a duplicate, and becomes the active window.
-->Microsoft AutoUpdate (MAU) version 3.18 and later includes the msupdate command-line tool. The msupdate tool can be used to start the update process for Microsoft applications produced for Mac, such as Office. The tool is primarily designed to give IT administrators more precise control over when updates are applied. You can download the latest version of MAU from this link.
msupdate works by sending Apple Events to the MAU daemon. On macOS 10.14 Mojave and later, you may see a privacy prompt when running msupdate for the first time. If you are using an enterprise management tool such as Jamf Pro, you should deploy a Privacy Preferences Policy Control (PPPC) payload to pre-approve access. Samples of such a payload can be downloaded from GitHub.
Use the following steps to start using the tool:
- Open the Terminal application
- Enter
cd /Library/Application Support/Microsoft/MAU2.0/Microsoft AutoUpdate.app/Contents/MacOS - Run
./msupdate --help
The following options are displayed:
Examples of how to use msupdate
Attention Mask Transformer
- Display the current configuration parameters for MAU:
./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 - Download and install latest available updates for Excel, wait for 180 seconds (3 minutes) before closing Excel, and display 'Excel will close in 3 minutes to install updates.' on macOS banner notification to notify user:
./msupdate --install --apps XCEL2019 -t 180 -m 'Excel will close in 3 minutes to install updates.'
Note
To use the -t and -m modifiers, you must be using Microsoft AutoUpdate 4.24 or later.
Application identifiers
The following table lists the Microsoft applications for Mac supported by MAU. The identifier is used when specifying the --apps parameter. When specifying multiple applications on the command-line, separate identifiers with a space.
Attention Makes Me Uncomfortable
| Application | Identifier |
|---|---|
| Word | MSWD2019 |
| Excel | XCEL2019 |
| PowerPoint | PPT32019 |
| Outlook | OPIM2019 |
| OneNote | ONMC2019 |
| MAU | MSau04 |
| OneDrive | ONDR18 |
| Teams | TEAM01 |
| Skype for Business | MSFB16 |
| Remote Desktop | MSRD10 |
| Intune Company Portal | IMCP01 |
| Defender ATP | WDAV00 |
| Edge Canary | EDCN01 |
| Edge Dev | EDDV01 |
| Edge Beta | EDBT01 |
| Edge Stable | EDGE01 |
Note
- The identifiers for the Office apps, such as Word and Outlook, can be used for Office for Mac (from an Office 365 or Microsoft 365 subscription plan) or for Office 2019 for Mac (either a retail or a volume licensed version).
- If an update is pending for MAU itself, that update must be applied before any applications can be updated.
- Identifiers are not case-sensitive when run interactively from the command-line, but use the character casing in the table when running from a management tool such as Jamf Pro.
- Microsoft Teams might use MAU to provide updates in some scenarios, such as if the Teams updater fails. But, you can't use msupdate to have MAU manage updates for Teams, because Teams doesn't provide admins the ability to deploy and manage updates. Instead, Teams is updated automatically approximately every two weeks with new features and quality updates. For more information, see Teams update process.
