Atualizar aplicativos da Microsoft para Mac usando msupdate

  • Artigo

O Microsoft AutoUpdate (MAU) versão 3.18 e posterior inclui a ferramenta de linha de comando msupdate. A ferramenta msupdate pode ser usada para iniciar o processo de atualização para aplicativos da Microsoft produzidos para Mac, como o Office. A ferramenta foi projetada principalmente para dar aos administradores de TI um controle mais preciso sobre quando as atualizações são aplicadas. Você pode baixar a versão mais recente do MAU neste link.

msupdate funciona usando XPC nativo para se comunicar com o daemon MAU. No macOS 10.14 Mojave e posterior, você pode ver um prompt de privacidade ao executar msupdate pela primeira vez. Se você estiver usando uma ferramenta de gerenciamento empresarial, como o Jamf Pro, deverá implantar uma carga de PPPC (Controle de Política de Preferências de Privacidade) para aprovar previamente o acesso. Exemplos de tal carga podem ser baixados do GitHub.

Use as seguintes etapas para começar a usar a ferramenta:

  1. Abrir o aplicativo Terminal
  2. Insira cd /Library/Application\ Support/Microsoft/MAU2.0/Microsoft\ AutoUpdate.app/Contents/MacOS
  3. Execute ./msupdate --help

As opções a seguir são exibidas:

 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

Exemplos de como usar msupdate

  • Exiba os parâmetros de configuração atuais para MAU: ./msupdate --config
  • Exiba os parâmetros de configuração atuais no formato legível pelo computador: ./msupdate --config --format plist
  • Listar todas as atualizações disponíveis: ./msupdate --list
  • Baixe e instale todas as atualizações disponíveis: ./msupdate --install
  • Baixe e instale as atualizações mais recentes para Word, Excel e PowerPoint:./msupdate --install --apps MSWD2019 XCEL2019 PPT32019
  • Baixe e instale uma atualização específica da versão para o Outlook: ./msupdate --install --apps OPIM2019 --version 16.17.180090901
  • Baixe e instale as atualizações disponíveis mais recentes para o Excel, aguarde 180 segundos (3 minutos) antes de fechar o Excel e exiba "O Excel fechará em 3 minutos para instalar atualizações" na notificação de faixa do macOS para notificar o usuário: ./msupdate --install --apps XCEL2019 -t 180 -m "Excel will close in 3 minutes to install updates."

Observação

Para usar os modificadores -t e -m, você deve estar usando o Microsoft AutoUpdate 4.24 ou posterior.

Identificadores de aplicativo

A tabela a seguir lista os aplicativos da Microsoft para Mac com suporte do MAU. O identificador é usado ao especificar o --apps parâmetro. Ao especificar vários aplicativos na linha de comando, separe os identificadores com um espaço.

Application Identificador
Word MSWD2019
Excel XCEL2019
PowerPoint PPT32019
Outlook OPIM2019
OneNote ONMC2019
MAU MSau04
OneDrive ONDR18
Clássico do Teams 1.0 TEAMS10
Equipes 2.1 TEAMS21
Skype for Business MSFB16
Área de Trabalho Remota MSRD10
Portal da Empresa do Intune IMCP01
Microsoft Defender para Ponto de Extremidade WDAV00
Microsoft Defender para consumidores WDAVCONSUMER
Microsoft Defender Shim WDAVSHIM
Ferramenta auxiliar de licenciamento OLIC02

Observação

  • Os identificadores dos aplicativos do Office, como Word e Outlook, podem ser usados para as seguintes versões:
    • Office para Mac (plano de assinatura do Microsoft 365 ou Office 365)
    • Office LTSC para Mac 2021 (licença de volume)
    • Office 2019 para Mac (licença de varejo ou volume)
  • Se uma atualização estiver pendente para o mau em si, essa atualização deve ser aplicada antes que qualquer aplicativo possa ser atualizado.
  • Os identificadores não são sensíveis a casos quando são executados interativamente na linha de comando, mas usam o invólucro de caracteres na tabela ao executar a partir de uma ferramenta de gerenciamento, como o Jamf Pro.
  • O Microsoft Teams pode usar o MAU para fornecer atualizações em alguns cenários, como se o atualizador do Teams falhar. Mas, você não pode usar msupdate para que o MAU gerencie atualizações para o Teams, pois o Teams não fornece aos administradores a capacidade de implantar e gerenciar atualizações. Em vez disso, o Teams é atualizado automaticamente aproximadamente a cada duas semanas com novos recursos e atualizações de qualidade. Para obter mais informações, confira Processo de atualização do Teams.