Instalar apps em dispositivos Windows 10 ou 11 com configurações personalizadas

Edições compatíveis com este recurso: Frontline Starter, Frontline Standard e Frontline Plus; Business Plus; Enterprise Standard e Enterprise Plus; Education Standard, Education Plus e Endpoint Education Upgrade; Enterprise Essentials e Enterprise Essentials Plus; Cloud Identity Premium.  Comparar sua edição

Você pode instalar software em dispositivos Windows inscritos no Gerenciamento de dispositivos Windows adicionando configurações personalizadas ao Google Admin Console. Você especifica o local do arquivo MSI do app em um arquivo XML definido como o valor da configuração personalizada.

Etapa 1: ver os detalhes necessários do app e criar o arquivo XML

Para criar o arquivo XML, é necessário saber o URL do app, o hash do arquivo e o ID do produto.

1. No dispositivo Windows, faça o download do arquivo MSI que você quer implantar.

   Observação:o arquivo de instalação do app precisa estar disponível no site do fornecedor ou em um local de servidor acessível por um protocolo http, https ou ftp onde o administrador de TI hospeda o arquivo.

   Por exemplo, você pode fazer o download do arquivo de instalação do 7‑Zip de https://www.7-zip.org/a/7z1900-x64.msi.

2. Abra o PowerShell.

3. Para gerar o hash, execute Get‑FileHash ‑Path PathToFile ‑Algorithm SHA256, onde PathToFile é o caminho para o arquivo de instalação do app. Registre o valor de hash, que é a string de 64 caracteres retornada no PowerShell.

   Por exemplo, se o arquivo MSI do 7‑zip estiver na pasta "Downloads", execute: Get‑FileHash ‑Path C:\Users*username*\Downloads\7z1900‑x64.msi ‑Algorithm SHA256.

4. Para encontrar o ID do produto:

   1. Copie o script do PowerShell a seguir em um editor de texto e salve-o como Get-MSIFileInformation.ps1.

      param(
      [parameter(Mandatory=$true)]
      [IO.FileInfo]$Path,
      [parameter(Mandatory=$true)]
      [ValidateSet("ProductCode","ProductVersion","ProductName")]
      [string]$Property
      )
      try {
          $WindowsInstaller = New-Object -ComObject WindowsInstaller.Installer
          $MSIDatabase = $WindowsInstaller.GetType().InvokeMember("OpenDatabase","InvokeMethod",$Null,$WindowsInstaller,@($Path.FullName,0))
          $Query = "SELECT Value FROM Property WHERE Property = '$($Property)'"
          $View = $MSIDatabase.GetType().InvokeMember("OpenView","InvokeMethod",$null,$MSIDatabase,($Query))
          $View.GetType().InvokeMember("Execute", "InvokeMethod", $null, $View, $null)
          $Record = $View.GetType().InvokeMember("Fetch","InvokeMethod",$null,$View,$null)
          $Value = $Record.GetType().InvokeMember("StringData","GetProperty",$null,$Record,1)
          return $Value
      }
      catch {
          Write-Output $_.Exception.Message
      }
      

   2. No PowerShell, execute *PathToScript*\Get‑MSIFileInformation.ps1 ‑Path PathToFile ‑Property ProductCode, em que PathToScript é o local do script do PowerShell e PathToFile é o caminho para o arquivo de instalação do MSI.

      Por exemplo, se você salvar o script do PowerShell na pasta "Desktop" para receber o código do produto do 7-Zip, execute C:\Usuários*nomedeusuário\Desktop\Get‑MSIFileInformation.ps1 ‑Path C:\Usuários*nomedeusuário\Downloads\7z1900‑x64.msi ‑Property ProductCode.

      O ID do produto é uma string alfanumérica entre colchetes. Por exemplo, {23170F69-40C1-2702-1900-00001000000}.

5. Crie o arquivo XML:

   1. Copie este XML para um arquivo de texto:

      <MsiInstallJob id="">
        <Product Version="1.0.0">
          <Download>
            <ContentURLList>
              <ContentURL>MSI-URL</ContentURL>
            </ContentURLList>
          </Download>
          <Enforcement>
            <CommandLine>/quiet</CommandLine>
            <TimeOut>5</TimeOut>
            <RetryCount>3</RetryCount>
            <RetryInterval>5</RetryInterval>
          </Enforcement>
          <Validation>
            <FileHash>{FileHash}</FileHash>
          </Validation>
        </Product>
      </MsiInstallJob>
      

   2. Nas tags <ContentURL>, substitua MSI-URL pelo URL do arquivo MSI.

   3. Nas tags <FileHash>, substitua FileHash pelo hash do arquivo MSI. É necessário incluir o valor do hash do arquivo entre colchetes, por exemplo: <FileHash>{A7803233EEDB6A4B59B3024CCF9292A6FFFB94507DC998AA67C5B745D197A5DC}</FileHash>.

   4. Se necessário, atualize os parâmetros de instalação nas tags <Enforcement>. Para mais detalhes, consulte a documentação da Microsoft.

   5. Salve o arquivo.

Etapa 2: adicionar a configuração personalizada

1. No Google Admin Console, acesse Menu Dispositivos Dispositivos móveis e endpoints Configurações Windows. 

   Acessar o Windows

   É preciso ter o privilégio de admin Serviços e dispositivos.

2. Clique em Configurações personalizadas.
3. Clique em Adicionar uma configuração personalizada.

4. Defina a configuração personalizada:

   1. No campo "OMA-URI", digite EnterpriseDesktop e selecione ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI//DownloadInstall.

   2. Em "OMA-URI", substitua pelo ID de produto do MSI codificando os colchetes. Para formatar corretamente, digite %7BProductID%7D, em que %7B é a versão codificada de "{" e %7D é a versão codificada de "}".

      Por exemplo, a string OMA-URI do 7-Zip é ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B23170F69-40C1-2702-1900-00001000000%7D/DownloadInstall

   3. Quando você seleciona o OMA-URI, o campo Nome é atualizado para "DownloadInstall". Digite um nome exclusivo que inclua o nome do app para identificá-lo na lista de configurações personalizadas. Por exemplo, "Instale 7-zip v19.0".

   4. Em Tipo de dado, selecione String (XML), clique em Fazer upload de XML e selecione o arquivo de configuração XML criado na primeira seção.

   5. (Opcional) Digite uma descrição.

5. Para escolher a qual unidade organizacional a configuração personalizada será aplicada, clique em Próxima. Se você quiser iniciar outra configuração personalizada, clique em Adicionar outra. Essas políticas só serão aplicadas a uma unidade organizacional depois que você clicar em Próxima e selecionar a unidade organizacional.

6. Escolha uma ou mais unidades organizacionais para aplicar a política.

7. Clique em Aplicar.

O app será instalado em até três horas se os dispositivos dos usuários estiverem conectados à Internet. Nos dispositivos não conectados, o app será instalado na próxima vez que o dispositivo acessar a Internet.

Etapa 3: verificar a instalação do app

Há diversas maneiras de confirmar que um app implantado com uma configuração personalizada foi instalado em um dispositivo. A verificação no dispositivo tem o menor atraso entre o momento em que você aplica a configuração personalizada e quando ela é recebida no dispositivo, porque é possível executar uma sincronização manual.

Desinstalar um app.

Você pode desinstalar apps que foram instalados com configurações personalizadas. Não é possível usar configurações personalizadas para desinstalar apps que foram instalados de outras formas.

1. No Google Admin Console, acesse Menu Dispositivos Dispositivos móveis e endpoints Configurações Windows. 

   Acessar o Windows

   É preciso ter o privilégio de admin Serviços e dispositivos.

2. Clique em Configurações personalizadas.
3. À esquerda, clique na unidade organizacional em que você quer desinstalar o app. Se quiser desinstalar o app para todos os usuários, selecione a unidade organizacional principal.

4. Aponte para a configuração personalizada e clique em Excluir ou Desativar. Para confirmar a exclusão, clique em Excluir.

   Se você tiver selecionado uma unidade organizacional filha que herdou a configuração personalizada, essa configuração será desativada, porque não é possível excluí-la no restante da organização. Se mudar de ideia, você poderá clicar em Herdar para instalar o app em dispositivos na unidade organizacional filha novamente.

Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas a que estão associados.