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

Edições compatíveis com esse 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. Compare 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 pelo protocolo http, https ou ftp em que 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:\Usuários*nomedeusuário*\Downloads\7z1900‑x64.msi ‑Algorithm SHA256.

4. Para encontrar o ID do produto:

   1. Copie este script do PowerShell 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, onde 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 o XML a seguir em 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 de hash do arquivo entre colchetes, por exemplo: <FileHash>{A7803233EEDB6A4B59B3024CCF9292A6FFFB94507DC998AA67C5B745D197A5DC}</FileHash>. 4. Se necessário, atualize os parâmetros de instalação nas <Enforcement> tags. Veja mais detalhes na documentação da Microsoft.

   4. 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

   Exige o privilégio de administrador Serviços e dispositivos.

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

4. Configure 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, onde %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, "Instalar o 7-zip v19.0".

   3. 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.

   4. (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 nos dispositivos dos usuários em até 3 horas se o dispositivo estiver conectado à Internet. Para dispositivos que não estão conectados, o app será instalado na próxima vez que o dispositivo for conectado.

Etapa 3: verificar a instalação do app

Você pode confirmar que um app implantado por uma configuração personalizada foi instalado em um dispositivo de várias maneiras. 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

   Exige o privilégio de administrador Serviços e dispositivos.

2. Clique em Configurações personalizadas.
3. À esquerda, selecione de qual unidade organizacional 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 às quais estão associados.