Realizar o sideload de aplicativos com o DISM

Artigo
06/19/2023

Você pode fazer sideload de aplicativos Universais do Windows de linha de negócios (LOB) usando o PowerShell ou o DISM (Gerenciamento e Manutenção de Imagens de Implantação). Os aplicativos do Windows incluem:

Normalmente, os aplicativos do Windows estão disponíveis apenas por meio da Microsoft Store. Você pode enviar aplicativos LOB do Windows para a Microsoft Store e disponibilizá-los fora da sua empresa. No entanto, você também pode desenvolver aplicativos do Windows para uso somente em sua empresa e adicioná-los a dispositivos Windows gerenciados por meio de um processo chamado sideload. Os aplicativos sideload não precisam ser certificados ou instalados por meio da Microsoft Store.

Veja o que você precisará saber para fazer sideload de aplicativos:

Como?	Descrição
Entender os conceitos de sideload	Apresenta alguns conceitos básicos que você precisará saber sobre o sideload de aplicativos.
Configurar computadores para requisitos de sideload	Mostra os requisitos a serem atendidos para fazer sideload de aplicativos em dispositivos que executam diferentes Edições do Windows. Inclui como usar Política de Grupo para configurar seus computadores corporativos para aplicativos de sideload.
Configurar computadores para o desenvolvimento de aplicativos da Microsoft Store	Mostra como configurar seu computador para ter uma licença de desenvolvedor que não expira. O computador pode ser usado para desenvolver aplicativos da Microsoft Store ou aplicativos empresariais que serão adicionados aos seus dispositivos corporativos.
Adicionar Aplicativos	Mostra como fazer sideload de aplicativos que você desenvolve.
Adicionar vários idiomas para aplicativos	Mostra como preparar uma imagem multilíngue, entrar na imagem, instalar todos os pacotes de recursos de aplicativo desejados (incluindo idioma) e, em seguida, usar Copiar Perfil para capturar a imagem.
Aplicativos de Inventário	Mostra como listar os aplicativos LOB instalados nos dispositivos em sua empresa ou em uma imagem offline do Windows.
Remover Aplicativos	Mostra como remover instâncias individuais de um aplicativo ou remover a configuração de provisionamento de um aplicativo.

Entender os conceitos de sideload

Os aplicativos do Windows diferem dos aplicativos da área de trabalho do Windows em seu design e da maneira como os usuários podem interagir com eles. Para saber mais sobre aplicativos do Windows, confira o que é um Aplicativo da Microsoft Store?.

Não é possível fazer sideload de um aplicativo que tenha sido baixado da Microsoft Store. Para instalar aplicativos do Windows que não fazem parte da sua linha de negócios, você deve usar a Microsoft Store. Para saber mais, consulte Gerenciando o acesso do cliente à Microsoft Store.

Os aplicativos LOB do Windows que não são assinados pela Microsoft Store podem ser sideload ou adicionados a um computador na empresa por meio de scripts em runtime por usuário. Eles também podem ser provisionados em uma imagem pela empresa para que o aplicativo seja registrado em cada novo perfil de usuário criado no computador. Os requisitos para fazer sideload do aplicativo por usuário ou na imagem são os mesmos, mas os cmdlets Windows PowerShell que você usa para adicionar, obter e remover os aplicativos são diferentes. Este tópico fornece etapas para ambos os métodos.

Antes de poder fazer sideload de aplicativos lob do Windows que não são assinados pela Microsoft Store, você precisará configurar o computador, consulte Configurar computadores para requisitos de sideload.

Quando você estiver desenvolvendo aplicativos LOB do Windows para sua empresa

Os aplicativos LOB do Windows que não são assinados pela Microsoft Store devem ser assinados criptograficamente. Os aplicativos só podem ser instalados em um computador que confia no certificado de assinatura.

Para obter mais informações sobre como assinar um aplicativo e usar certificados, consulte Ferramentas de Empacotamento de Aplicativos.

No entanto, você pode usar uma licença de desenvolvedor para adicionar aplicativos que estão em desenvolvimento ao seu computador. Para obter mais informações sobre como testar aplicativos que estão em desenvolvimento, consulte Obter uma licença de desenvolvedor.

Você pode usar Política de Grupo para configurar seus computadores ingressados no domínio para ter uma licença de desenvolvedor que não expire para dar suporte ao desenvolvimento de aplicativos. Depois que os computadores estiverem configurados, você não precisará se conectar à Internet para obter ou renovar uma licença. Consulte Configurar computadores para desenvolver aplicativos da Microsoft Store para obter mais informações.

Configurar computadores para requisitos de sideload

Até que o dispositivo atenda a todos os requisitos de sideload, os blocos do aplicativo no menu Iniciar mostrarão um "X" no canto inferior direito para indicar que um problema está impedindo a execução do aplicativo.

Em alguns casos, parte desses requisitos inclui o uso de uma chave do produto de sideload para fornecer direitos de uso necessários para implantar aplicativos diretamente em dispositivos sem precisar instalá-los por meio da Microsoft Store pública.

Antes de adicionar e executar aplicativos lob do Windows sideload que não são assinados pela Microsoft Store, você deve configurar seu dispositivo com base nas seguintes condições:

Para os dispositivos ingressados em um grupo de trabalho, você deve:
- Ative a chave do produto (Product Key) de sideload no dispositivo.
- E habilite a configuração Permitir que todos os aplicativos confiáveis instalem Política de Grupo. Consulte Usar Política de Grupo para configurar seus computadores corporativos para aplicativos de sideload.
Isso se aplica a:
- Windows 10 Enterprise
- Windows 8.1 Enterprise
- O Windows 8 Enterprise
- Windows Embedded 8.1 Industry Enterprise
- Windows 8.1 Pro Update
Para os dispositivos que serão ingressados em um domínio do Active Directory, você deve:
- Adicione o dispositivo a um domínio Active Directory.
- E habilite a configuração Permitir que todos os aplicativos confiáveis instalem Política de Grupo. Consulte Usar Política de Grupo para configurar seus computadores corporativos para aplicativos de sideload.
Isso se aplica a:
- Windows 10 Enterprise
- Windows 8.1 Enterprise
- O Windows 8 Enterprise
- Windows Embedded 8.1 Industry Enterprise
- Windows 8.1 Pro Update
- Windows Server 2016 Technical Preview
- Atualização do Windows Server 2012 R2
- Windows Server 2012
Para os dispositivos que exigirão um sideload da chave do produto (Product Key), seja o dispositivo ingressado no domínio ou membro de um grupo de trabalho, você deve:
- Ative a chave do produto (Product Key) de sideload no dispositivo.
- E habilite a configuração Permitir que todos os aplicativos confiáveis instalem Política de Grupo. Consulte Usar Política de Grupo para configurar seus computadores corporativos para aplicativos de sideload.
Isso se aplica a:
- Windows 10 Pro
- Windows RT 8.1
- Windows 8.1 Pro
- Windows RT
- Windows 8 Pro
- Windows Embedded 8.1 Industry Pro
Para determinados dispositivos do Setor do Windows Embedded 8, você não precisa mais de uma chave do produto de sideload se o dispositivo for ingressado no domínio ou membro de um grupo de trabalho. Nesse caso, você deve:
- Habilite a configuração Permitir que todos os aplicativos confiáveis instalem Política de Grupo no dispositivo.
Para obter mais informações sobre sideload no Windows Embedded 8 Industry, consulte Guia empresarial para instalar aplicativos de Windows 8 Universais no Windows Embedded 8 Industry.

Isso se aplica a:
- Windows Embedded 8.1 Industry Pro Update
- Windows Embedded 8.1 Industry Enterprise Update

Use Política de Grupo para configurar seus computadores corporativos para aplicativos de sideload

Abra o Editor de Gerenciamento de Política de Grupo para um gpo (objeto Política de Grupo) baseado em domínio ao qual você aplicará a configuração de política de grupo, conforme especificado abaixo, aos PCs selecionados.

Observação

As etapas fornecidas neste procedimento pressupõem que você entenda os conceitos básicos de Política de Grupo design e operações. Para administrar Política de Grupo baseadas em domínio. Você precisará instalar o Console de Gerenciamento de Política de Grupo instalado com os Recursos sob Demanda das Ferramentas de Administração de Servidor Remoto. Para obter mais informações sobre Política de Grupo, consulte Política de Grupo para iniciantes e o techcenter Política de Grupo.
Clique para expandir a Configuração do Computador, Modelos Administrativos, Componentes do Windows e, em seguida, Implantação de Pacote de Aplicativos.
Clique duas vezes na configuração Permitir que todos os aplicativos confiáveis instalem .
Na janela Permitir que todos os aplicativos confiáveis instalem , clique em Habilitado e clique em OK.

Definir o Política de Grupo para permitir que aplicativos confiáveis atualizem a chave do HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Appx\AllowAllTrustedApps = 1 Registro.

Para ativar uma chave do produto (Product Key) de sideload

Abra um prompt de comando com privilégios de administrador e digite o seguinte para adicionar a chave do produto sideload:
```
Slmgr /ipk <sideloading product key>
```
Onde <sideloading product key> está a chave de 25 dígitos para habilitar o sideload no computador.
Ative a chave de sideload digitando:
```
slmgr /ato ec67814b-30e6-4a50-bf7b-d55daf729d1e
```
Observação

O GUID de ativação não é o mesmo que a chave do produto sideload. O GUID de ativação sempre será ec67814b-30e6-4a50-bf7b-d55daf729d1e.

Configurar computadores para o desenvolvimento de aplicativos do Windows

Você pode configurar seus computadores para ter uma licença de desenvolvedor que não expira. Depois que os computadores estiverem configurados, você não precisará se conectar à Internet para obter ou renovar uma licença. Seu computador deve ser membro de um domínio e estar executando um dos seguintes sistemas operacionais:

Windows 10 Enterprise
Windows 8.1 Enterprise
Windows 8 Pro

Observação

Para habilitar o sideload em Windows 8 Pro dispositivo, você deve usar uma chave de ativação do produto de sideload. Para obter mais informações, consulte Configurar computadores para requisitos de sideload

Para configurar seus computadores corporativos com uma licença de desenvolvedor

Abra o Editor de Gerenciamento de Política de Grupo para um gpo (objeto de Política de Grupo) baseado em domínio ao qual você aplicará as configurações de política de grupo, conforme especificado abaixo, aos PCs selecionados.

Observação

As etapas fornecidas neste procedimento pressupõem que você entenda os conceitos básicos de Política de Grupo design e operações. Para administrar Política de Grupo baseadas em domínio. Você precisará instalar o Console de Gerenciamento de Política de Grupo instalado com os Recursos sob Demanda das Ferramentas de Administração de Servidor Remoto. Para obter mais informações sobre Política de Grupo, consulte Política de Grupo para iniciantes e o techcenter Política de Grupo.
Clique para expandir a Configuração do Computador, Modelos Administrativos, Componentes do Windows e, em seguida, Implantação de Pacote de Aplicativos.
Clique duas vezes na configuração Permitir desenvolvimento de aplicativos do Windows sem instalar uma licença de desenvolvedor .
Na janela Permitir o desenvolvimento de aplicativos do Windows sem instalar uma licença de desenvolvedor , clique em Habilitado e clique em OK.
Clique duas vezes na configuração Permitir que todos os aplicativos confiáveis instalem .
Na janela Permitir que todos os aplicativos confiáveis instalem , clique em Habilitado e clique em OK.

Definir o Política de Grupo para permitir o desenvolvimento de aplicativos do Windows sem instalar uma licença de desenvolvedor atualiza a chave do HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Appx\AllowDevelopmentWithoutDevLicense = 1 Registro.

Definir o Política de Grupo para permitir que aplicativos confiáveis atualizem a chave do HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Appx\AllowAllTrustedApps = 1 Registro.

Adicionar Aplicativos

Há duas maneiras de adicionar aplicativos. Um usuário pode adicionar um pacote de aplicativo, o que disponibilizará o aplicativo apenas para esse usuário. Ou o aplicativo pode ser instalado na imagem do Windows, o que disponibilizará o aplicativo para cada usuário da imagem do Windows no primeiro logon ou no próximo logon, se a conta de usuário já estiver criada. Esse segundo caso é chamado de provisionamento de um pacote de aplicativo.

Adicionar um pacote de aplicativos

Você pode instalar um pacote de aplicativos (.appx ou .appxbundle) por usuário usando o cmdlet do PowerShell add-appxpackage . Não há limite para o número de aplicativos LOB que você pode adicionar para cada usuário.

Adicionar um aplicativo LOB a uma conta de usuário

No Windows PowerShell, adicione um pacote de arquivos .appx (ou .appxbundle). Inclua todos os pacotes de aplicativo de dependência necessários ao adicionar o aplicativo. Por exemplo, digite:
```
add-appxpackage C:\app1.appx -DependencyPath C:\winjs.appx
```
Para obter mais informações, consulte Cmdlets de Instalação de Aplicativo no Windows PowerShell.

Adicionar um aplicativo LOB provisionado a uma imagem do Windows

Os aplicativos instalados na imagem do Windows são chamados de aplicativos provisionados . Os aplicativos provisionados são preparados na imagem e estão agendados para serem instalados para cada usuário da imagem do Windows no primeiro logon ou no próximo logon, se a conta de usuário já estiver criada.

Você pode adicionar esses aplicativos a uma imagem do Windows ao inicializar no modo de auditoria antes de implantar a imagem usando os comandos de provisionamento de aplicativo DISM. Para obter mais informações sobre o modo de auditoria, consulte Visão geral do modo de auditoria.

Os aplicativos provisionados são específicos para o computador e não serão movidos com o usuário. Você só pode instalar 24 aplicativos provisionados em uma imagem.

Em uma imagem do Windows que já foi implantada, você deve usar o cmdlet Add-AppxPackage no PowerShell. Se você usar os comandos de provisionamento de aplicativo DISM em uma imagem do Windows implantada com usuários ativos, deverá registrar todos os usuários fora da imagem, para que você seja o único usuário conectado, antes de executar o comando.

Adicionar um aplicativo LOB provisionado a uma imagem do Windows

Use a ferramenta de linha de comando DISM (Serviço e Gerenciamento de Imagens de Implantação) ou cmdlets do PowerShell para adicionar o aplicativo LOB sem uma licença da Microsoft Store. Por exemplo, em um prompt de comando com privilégios elevados, digite:
```
DISM /Online /Add-ProvisionedAppxPackage /PackagePath:C:\App1.appx /SkipLicense
```
Ou, em um prompt Windows PowerShell, digite:
```
Add-AppxProvisionedPackage -Online -FolderPath C:\Appx -SkipLicense
```
Para obter mais informações, consulte DisM App Package (.appx ou .appxbundle) Serviço Command-Line Options ou Cmdlets DISM. Para obter informações sobre plataformas com suporte do DISM, consulte Plataformas com suporte do DISM.

Observação

O computador não precisa ser ingressado em um domínio ou ter uma chave do produto de sideload ativada antes de instalar aplicativos LOB provisionados. No entanto, os aplicativos não serão executados até que o computador atenda a esse requisito de sideload. Para obter mais informações, consulte Personalizar a tela inicial.

Atualizar um aplicativo LOB provisionado depois que ele for adicionado a uma imagem do Windows

Para atualizar um aplicativo provisionado, você precisará atualizar o aplicativo para cada usuário que se conectou à imagem do Windows provisionada com o aplicativo:

Atualizar um aplicativo LOB provisionado para uma imagem do Windows

Use o PowerShell para atualizar o aplicativo LOB sem uma licença da Microsoft Store. Isso deve ser feito para cada usuário que entrou no computador executando a imagem do Windows. Por exemplo, se você instalou a versão original do aplicativo, 1.0.0.0, que agora precisa ser atualizada para a versão 1.0.0.1, em uma sessão do PowerShell, digite:
```
Add-AppxPackage -Path App1_1.0.0.2 -DependencyPath C:\appx\WinJS.appx
```
Onde c:\appx\WinJS.appx é o caminho para o pacote de dependência.
Depois de atualizar seu aplicativo, você pode verificar a versão do aplicativo atualizado. Em uma sessão do PowerShell, digite:
```
Get-AppxPackage | Out-GridView
```

Adicionar vários idiomas para aplicativos

Para preparar uma imagem multilíngue, entre na imagem, instale todos os pacotes de recursos de aplicativo desejados (incluindo idioma) e, em seguida, use Copiar Perfil para capturar a imagem.

Preparando uma imagem multilíngue para um aplicativo

Crie um unattend.xml com o seguinte conteúdo para c:\unattend.xml:

<?xml version="1.0" encoding="utf-8"?>
<unattend xmlns="urn:schemas-microsoft-com:unattend">
    <settings pass="specialize">
        <component name="Microsoft-Windows-Shell-Setup" processorArchitecture="x86" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <CopyProfile>true</CopyProfile>
            <RegisteredOrganization />
            <RegisteredOwner />
        </component>
    </settings>
    <cpi:offlineImage cpi:source="catalog:d:/desktop/x86 clgs/install_windows vista ultimate.clg" xmlns:cpi="urn:schemas-microsoft-com:cpi" />
</unattend>

Observação

Consulte Alterar o idioma usado em aplicativos para obter informações sobre como definir o idioma e instalar atualizações da Microsoft Store.

Entre em uma conta de usuário administrador local do OOBE na imagem limpo.

Importante

Ao adicionar um idioma específico a um aplicativo do Windows, você também gostaria de adicionar pacotes de idiomas ao Windows para os mesmos idiomas que você fez para o aplicativo windows.
Adicione os idiomas desejados à lista de preferências de idioma do usuário atual.
Instalar atualizações de aplicativo usando uma conta da Microsoft Store (conta MSA)
1. Entre na Microsoft Store com uma conta MSA.
  
  Observação
  
  Somente a Microsoft Store. Não converta a conta local em MSA.
  
  Se você não tiver uma conta MSA, poderá atualizar aplicativos sem uma conta da Microsoft Store.
2. Verifique se há atualizações e instale novos pacotes de recursos de idioma.
3. Saia da Microsoft Store e remova a conta MSA.

Abra um prompt de comando com privilégios elevados e execute:

Sysprep.exe /generalize /oobe /reboot /unattend:C:\unattend.xml

Você deve ver a inicialização do computador para OOBE. Todos os idiomas que você adicionou antes de Copiar Perfil devem estar presentes neste ponto.

Instalar atualizações de aplicativo sem usar uma conta da Microsoft Store (conta MSA)

Depois que o computador terminar de instalar, abra o prompt de comando como administrador.
execute Start ms-windows-store:Updates.
Você verá a página de Atualizações da Microsoft Store. Você deverá ver as atualizações pendentes exibidas.
Toque em Instalar para instalar as atualizações.

Aplicativos de inventário

Você pode listar os aplicativos LOB instalados na imagem offline ou online do Windows e obter informações adicionais sobre os pacotes.

Listar aplicativos LOB por conta de usuário

Você pode obter uma lista dos aplicativos do Windows instalados para uma conta de usuário específica no computador. Você deve abrir o PowerShell com privilégios de administrador para listar os pacotes de um usuário diferente do usuário atual. Por exemplo, no prompt do PowerShell, digite:
```
Get-AppxPackage -AllUsers
```
Você pode obter uma lista de pacotes instalados para um usuário específico. Você deve abrir o PowerShell com privilégios de administrador para listar os pacotes de um usuário diferente do usuário atual. Por exemplo, no prompt do PowerShell, digite:
```
Get-AppxPackage -Name Package1 -User domain\username
```
Você também pode obter o manifesto de um pacote do aplicativo (.appx) que inclui informações como a ID do pacote. Por exemplo, no prompt do PowerShell, digite:
```
Get-AppxPackageManifest -Package Package1
```
Você pode usar o pipeline para obter o manifesto de um pacote do aplicativo (.appx) se não souber o nome completo do pacote. Por exemplo, no prompt do PowerShell, digite:
```
(Get-AppxPackage -Name "*WinJS*" | Get-AppxPackageManifest).package.applications.application.id
```

Listar aplicativos LOB provisionados em uma imagem do Windows

Você pode obter uma lista dos pacotes provisionados em uma imagem do Windows que será instalada para cada novo usuário usando Dism.exe ou PowerShell. Por exemplo, em um prompt do PowerShell, digite:
```
Get-AppxProvisionedPackage -Path c:\offline
```
Ou, em um prompt de comando, digite:
```
DISM.exe /Image:C:\test\offline /Get-ProvisionedAppxPackages
```

Para obter mais informações, consulte Fazer inventário de uma imagem ou componente usando DISM.

Remover Aplicativos

Você pode remover instâncias individuais de um aplicativo ou remover a configuração de provisionamento de um aplicativo.

Remover aplicativos LOB por conta de usuário

Você pode remover um único aplicativo somente para o usuário atual. Por exemplo, no prompt de comando, digite:
```
Remove-AppxPackage Package1
```

Remover aplicativos LOB provisionados em uma imagem do Windows

Quando você remove um aplicativo provisionado, o aplicativo não será instalado para novas contas de usuário. Para o usuário conectado no momento e outras contas de usuário que estão ativas no computador, o aplicativo não será removido dessas contas. O aplicativo precisará ser desinstalado para esses aplicativos existentes.

Por exemplo, para remover um aplicativo LOB provisionado, MyAppxPkg, de uma imagem do Windows, em um prompt do PowerShell com privilégios elevados, digite:
```
Remove-AppxProvisionedPackage -Online -PackageName MyAppxPkg
```
Ou, em um prompt de comando, digite:
```
DISM.exe /Online /Remove-ProvisionedAppxPackage /PackageName:microsoft.app1_1.0.0.0_neutral_en-us_ac4zc6fex2zjp
```

Cmdlets de instalação do aplicativo no Windows PowerShell

Opções de Command-Line de manutenção do pacote de aplicativos DISM (.appx ou .appxbundle)

Ferramentas de Empacotamento de Aplicativos

Cmdlets do módulo AppX

Alterar o idioma usado em aplicativos

Cmdlets de DISM

Plataformas com suporte do DISM

Guia empresarial para instalar aplicativos de Windows 8 Universal no Windows Embedded 8 Industry

Obter uma licença de desenvolvedor

Política de Grupo para iniciantes

Política de Grupo Techcenter

Personalizar a Tela Inicial