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.  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, em que 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*nomedeusuário*\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:\Users*username\Desktop\Get‑MSIFileInformation.ps1 ‑Path C:\Users*username\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 de 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.

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

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

   Exige o privilégio de administrador 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 às quais estão associados.