Aggiornare le applicazioni Microsoft per Mac usando msupdate

  • Articolo

Microsoft AutoUpdate (MAU) versione 3.18 e successive include lo strumento da riga di comando msupdate. Lo strumento msupdate può essere usato per avviare il processo di aggiornamento per le applicazioni Microsoft prodotte per Mac, ad esempio Office. Lo strumento è progettato principalmente per offrire agli amministratori IT un controllo più preciso sull'applicazione degli aggiornamenti. È possibile scaricare la versione più recente di MAU da questo collegamento.

msupdate funziona usando XPC nativo per comunicare con il daemon MAU. In macOS 10.14 Mojave e versioni successive, potrebbe essere visualizzato un messaggio di richiesta sulla privacy quando si esegue msupdate per la prima volta. Se si usa uno strumento di gestione aziendale, ad esempio Jamf Pro, è consigliabile distribuire un payload PPPC (Privacy Preferences Policy Control) per preapprovare l'accesso. Esempi di tale payload possono essere scaricati da GitHub.

Per iniziare a usare lo strumento, seguire questa procedura:

  1. Aprire l'applicazione Terminale
  2. Immettere cd /Library/Application\ Support/Microsoft/MAU2.0/Microsoft\ AutoUpdate.app/Contents/MacOS
  3. Eseguire ./msupdate --help

Vengono visualizzate le opzioni seguenti:

 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
    -t | --terminate <secs>  Number of seconds to wait before closing opened applications in order for updates to complete
       -m | --message <msg>  Optional message to display on macOS banner notification to notify user

Nota

L'opzione --version è supportata solo per gli aggiornamenti dell'applicazione seguenti: Word, Excel, PowerPoint, Outlook, OneNote

Esempi di come usare msupdate

  • Visualizzare i parametri di configurazione correnti per MAU: ./msupdate --config
  • Visualizzare i parametri di configurazione correnti in formato leggibile dal computer: ./msupdate --config --format plist
  • Elencare tutti gli aggiornamenti disponibili: ./msupdate --list
  • Scaricare e installare tutti gli aggiornamenti disponibili: ./msupdate --install
  • Scaricare e installare gli aggiornamenti più recenti per Word, Excel e PowerPoint:./msupdate --install --apps MSWD2019 XCEL2019 PPT32019
  • Scaricare e installare un aggiornamento specifico della versione per Outlook: ./msupdate --install --apps OPIM2019 --version 16.17.180090901
  • Scaricare e installare gli aggiornamenti disponibili più recenti per Excel, attendere 180 secondi (3 minuti) prima di chiudere Excel e visualizzare "Excel si chiuderà tra 3 minuti per installare gli aggiornamenti". Nella notifica banner macOS inviare una notifica all'utente: ./msupdate --install --apps XCEL2019 -t 180 -m "Excel will close in 3 minutes to install updates."

Nota

Per usare i modificatori -t e -m, è necessario usare Microsoft AutoUpdate 4.24 o versione successiva.

Identificatori dell'applicazione

Nella tabella seguente sono elencate le applicazioni Microsoft per Mac supportate da MAU. L'identificatore viene usato quando si specifica il --apps parametro . Quando si specificano più applicazioni nella riga di comando, separare gli identificatori con uno spazio.

Applicazione Identificatore
Excel XCEL2019
Portale aziendale di Intune IMCP01
Strumento helper licenze OLIC02
MAU MSau04
Microsoft Defender per i consumer WDAVCONSUMER
Microsoft Defender per endpoint WDAV00
Microsoft Defender Shim WDAVSHIM
OneDrive ONDR18
OneNote ONMC2019
Outlook OPIM2019
PowerPoint PPT32019
Assistenza rapida MSQA01
Desktop remoto MSRD10
Assistenza remota MSRH01
Skype for Business MSFB16
Teams 1.0 classico TEAMS10
Teams 2.1 TEAMS21
Word MSWD2019

Nota

  • Gli identificatori per le app di Office, ad esempio Word e Outlook, possono essere usati per le versioni seguenti:
    • Microsoft 365 per Mac
    • Office LTSC per Mac 2024 (contratto multiplo)
    • Office LTSC per Mac 2021 (contratto multiplo)
  • Se un aggiornamento è in sospeso per mau stesso, tale aggiornamento deve essere applicato prima che qualsiasi applicazione possa essere aggiornata.
  • Gli identificatori non fanno distinzione tra maiuscole e minuscole quando vengono eseguiti in modo interattivo dalla riga di comando, ma usano la combinazione di maiuscole e minuscole nella tabella quando vengono eseguiti da uno strumento di gestione come Jamf Pro.
  • Microsoft Teams potrebbe usare MAU per fornire aggiornamenti in alcuni scenari, ad esempio se l'aggiornamento di Teams ha esito negativo. Tuttavia, non è possibile usare msupdate per consentire a MAU di gestire gli aggiornamenti per Teams, perché Teams non offre agli amministratori la possibilità di distribuire e gestire gli aggiornamenti. Teams viene invece aggiornato automaticamente ogni due settimane con nuove funzionalità e aggiornamenti qualitativi. Per altre informazioni, vedere Processo di aggiornamento di Teams.