Atualizar aplicações Microsoft para Mac com o msupdate

  • Artigo

A versão 3.18 e posterior do Microsoft AutoUpdate (MAU) inclui a ferramenta de linha de comandos msupdate. A ferramenta msupdate pode ser utilizada para iniciar o processo de atualização para aplicações Microsoft produzidas para Mac, como o Office. A ferramenta foi concebida principalmente para dar aos administradores de TI um controlo mais preciso sobre quando as atualizações são aplicadas. Pode transferir a versão mais recente do MAU a partir desta ligação.

o msupdate funciona através da utilização de XPC nativo para comunicar com o daemon MAU. No macOS 10.14 Mojave e posterior, poderá ver um pedido de privacidade ao executar o msupdate pela primeira vez. Se estiver a utilizar uma ferramenta de gestão empresarial, como o Jamf Pro, deve implementar um payload de Controlo de Política de Preferências de Privacidade (PPPC) para pré-aprovar o acesso. Os exemplos de um payload deste tipo podem ser transferidos a partir do GitHub.

Utilize os seguintes passos para começar a utilizar a ferramenta:

  1. Abrir a aplicação 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ó é suportada para as seguintes atualizações de aplicações: Word, Excel, PowerPoint, Outlook, OneNote

Exemplos de como utilizar o msupdate

  • Apresentar os parâmetros de configuração atuais para MAU: ./msupdate --config
  • Apresentar 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
  • Transfira e instale todas as atualizações disponíveis: ./msupdate --install
  • Transfira e instale as atualizações mais recentes para Word, Excel e PowerPoint:./msupdate --install --apps MSWD2019 XCEL2019 PPT32019
  • Transfira e instale uma atualização específica da versão para o Outlook: ./msupdate --install --apps OPIM2019 --version 16.17.180090901
  • Transfira e instale as atualizações mais recentes disponíveis para o Excel, aguarde 180 segundos (3 minutos) antes de fechar o Excel e apresente "O Excel fechará dentro de 3 minutos para instalar atualizações" na notificação da faixa do macOS para notificar o utilizador: ./msupdate --install --apps XCEL2019 -t 180 -m "Excel will close in 3 minutes to install updates."

Observação

Para utilizar os modificadores -t e -m, tem de utilizar o Microsoft AutoUpdate 4.24 ou posterior.

Identificadores de aplicação

A tabela seguinte lista as aplicações da Microsoft para Mac suportadas pela MAU. O identificador é utilizado ao especificar o --apps parâmetro . Ao especificar várias aplicações na linha de comandos, separe os identificadores com um espaço.

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

Observação

  • Os identificadores das aplicações do Office, como o Word e o Outlook, podem ser utilizados 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 a própria MAU, essa atualização tem de ser aplicada antes de as aplicações poderem ser atualizadas.
  • Os identificadores não são sensíveis a maiúsculas e minúsculas quando são executados interativamente a partir da linha de comandos, mas utilizam a caixa de carateres na tabela ao executar a partir de uma ferramenta de gestão, como o Jamf Pro.
  • O Microsoft Teams pode utilizar o MAU para fornecer atualizações em alguns cenários, como se o atualizador do Teams falhasse. No entanto, não pode utilizar o msupdate para que o MAU faça a gestão de atualizações para o Teams, uma vez que o Teams não fornece aos administradores a capacidade de implementar e gerir atualizações. Em vez disso, o Teams é atualizado automaticamente aproximadamente a cada duas semanas com novas funcionalidades e atualizações de qualidade. Para obter mais informações, veja Processo de atualização do Teams.