Atualizar aplicativos da Microsoft para Mac usando msupdate

O MAU (Microsoft AutoUpdate) versão 3.18 e posteriores incluem a ferramenta de linha de comando msupdate. A ferramenta msupdate pode ser usada para iniciar o processo de atualização de 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ê poderá ver uma solicitação de privacidade ao executar msupdate pela primeira vez. Se você estiver usando uma ferramenta de gerenciamento corporativo, como o Jamf Pro, deverá implantar um conteúdo de Controle de Política de Preferências de Privacidade (PPPC) para pré-aprovar o acesso. Amostras dessa carga podem ser baixadas do GitHub.

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

  1. Abra 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

Observação

A --version opção só tem suporte para as seguintes atualizações de aplicativo: Word, Excel, PowerPoint, Outlook, OneNote

Exemplos de como usar msupdate

  • Exiba os parâmetros de configuração atuais para o MAU: ./msupdate --config
  • Exiba os parâmetros de configuração atuais em formato legível por máquina: ./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 do Word, Excel e PowerPoint:./msupdate --install --apps MSWD2019 XCEL2019 PPT32019
  • Baixe e instale uma atualização específica de versão do Outlook: ./msupdate --install --apps OPIM2019 --version 16.17.180090901
  • Baixe e instale as últimas atualizações disponíveis para o Excel, aguarde 180 segundos (3 minutos) antes de fechar o Excel e exiba "O Excel será fechado em 3 minutos para instalar atualizações". no macOS notificação de faixa 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 por um espaço.

Application Identificador
Excel XCEL2019
Portal da Empresa do Intune IMCP01
Ferramenta auxiliar de licenciamento OLIC02
MAU MSau04
Microsoft Copilot MSCP10
Microsoft Defender para Consumidores WDAVCONSUMIDOR
Microsoft Defender para Ponto de Extremidade WDAV00
Microsoft Defender Shim WDAVSHIM
OneDrive ONDR18
OneNote ONMC2019
Outlook OPIM2019
PowerPoint PPT32019
Assistência Rápida MSQA01
Ajuda remota MSRH01
Skype for Business MSFB16
Teams 1.0 clássico TEAMS10
Teams 2.1 TEAMS21
Windows App MSRD10
Word MSWD2019

Observação

  • A Área de Trabalho Remota agora é chamada de Windows App. Atualize sua configuração com o novo nome para continuar recebendo atualizações.
  • Os identificadores dos aplicativos do Office, como Word e Outlook, podem ser usados para as seguintes versões:
    • Microsoft 365 para Mac
    • Office LTSC para Mac 2024 (licença de volume)
    • Office LTSC para Mac 2021 (licença de volume)
  • Se uma atualização estiver pendente para o próprio MAU, essa atualização deverá ser aplicada antes que qualquer aplicativo possa ser atualizado.
  • Os identificadores não diferenciam maiúsculas de minúsculas quando executados interativamente na linha de comando, mas usam o uso de maiúsculas e minúsculas na tabela ao executar 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. Porém, 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, consulte Processo de atualização do Teams.
  • Last updated on