As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Solução de problemas de construtores de imagens
A seguir estão os problemas que podem ocorrer quando você usa os criadores de imagens do Amazon WorkSpaces Applications.
**Topics**
+ [Não consigo me conectar à Internet pelo criador de imagens.](#troubleshooting-01)
+ [Quando tento instalar o aplicativo, vejo o erro de que a versão do sistema operacional não é compatível.](#troubleshooting-02)
+ [Quero usar um PowerShell script do Windows para abrir meus aplicativos.](#use-powershell-launch-application)
+ [Quero disponibilizar ClickOnce aplicativos para os usuários.](#clickonce-applications)
+ [Quando me conecto ao construtor de imagens, vejo uma tela de login que pede para pressionar CTRL \$1 Alt \$1 Delete para fazer login. Mas a máquina local intercepta os toques do teclado.](#troubleshooting-03)
+ [Quando alternei entre os modos admin e teste, vi uma solicitação de senha. Não sei como obter uma senha.](#troubleshooting-04)
+ [Recebo um erro quando adiciono meu aplicativo instalado.](#troubleshooting-05)
+ [Saí acidentalmente de um serviço em segundo plano no construtor de imagens e me desconectei. Agora não consigo me conectar ao construtor de imagens.](#troubleshooting-06)
+ [O aplicativo não inicia no modo de teste.](#troubleshooting-07)
+ [O aplicativo não conseguiu se conectar a um recurso de rede em minha VPC.](#troubleshooting-08)
+ [Personalizo a área de trabalho do meu construtor de imagens, mas as alterações não estão disponíveis quando me conecto a uma sessão depois de iniciar uma frota na imagem que criei.](#troubleshooting-09)
+ [Ao iniciar meu aplicativo, falta um parâmetro de linha de comando.](#troubleshooting-10)
+ [Não consigo usar minha imagem com uma frota depois que instalo um aplicativo antivírus.](#troubleshooting-11)
+ [Não consegui criar uma imagem.](#troubleshooting-12)
+ [A `create-image` operação do Assistente de Imagem falhou com uma mensagem de erro informando que o acesso ao PrewarmManifest .txt foi negado](#create-image-cli-operation-fails)
## Não consigo me conectar à Internet pelo criador de imagens.
Por padrão, os criadores de imagens não conseguem se comunicar com a Internet. Para resolver esse problema, inicie o criador de imagens em uma sub-rede VPC com acesso à Internet. Você pode permitir acesso à Internet a partir da sua sub-rede VPC usando um [gateway NAT](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html). Se preferir, você pode configurar um gateway da Internet em sua VPC e anexar um endereço IP elástico ao construtor de imagens. Para obter mais informações, consulte [Rede e acesso para WorkSpaces aplicativos da Amazon](managing-network.md).
## Quando tento instalar o aplicativo, vejo o erro de que a versão do sistema operacional não é compatível.
Somente aplicativos que podem ser instalados no Windows Server 2016, Windows Server 2019, Windows Server 2022 e Windows Server 2025 podem ser adicionados a uma imagem de WorkSpaces aplicativos. Verifique se seu aplicativo é compatível com um desses sistemas operacionais, conforme aplicável ao seu criador de imagens.
## Quero usar um PowerShell script do Windows para abrir meus aplicativos.
Você pode usar PowerShell scripts do Windows para abrir seus aplicativos na instância da frota. Você talvez queira fazer isso para configurar o aplicativo ou ambiente antes que o aplicativo seja aberto. Para iniciar um PowerShell script do Windows para seu aplicativo, especifique o PowerShell arquivo.exe no Image Assistant. Navegue até `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` e especifique os seguintes parâmetros de inicialização:
-arquivo "C:\$1Path\$1To\$1PowerShell\$1 Script.ps1"
**nota**
Para permitir que o script especificado abra o aplicativo, você deve substituir a política de execução do PowerShell script. Para fazer isso, adicione **-ExecutionPolicy Bypass** ao parâmetro de execução.
## Quero disponibilizar ClickOnce aplicativos para os usuários.
Para disponibilizar um ClickOnce aplicativo para seus usuários de WorkSpaces aplicativos, você deve instalar o aplicativo em seu criador de imagens primeiro como administrador e depois como usuário de modelo. Como os ClickOnce aplicativos exigem uma instalação específica do usuário, você deve instalar seu aplicativo como um usuário modelo para permitir que os usuários iniciem o aplicativo a partir de instâncias da frota. Para instalar o ClickOnce aplicativo como administrador e, em seguida, como usuário de modelo, execute estas etapas.
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. No painel de navegação esquerdo, selecione **Images (Imagens)**, **Image Builder (Criador de imagens)**.
1. Na lista, escolha o criador de imagens que você deseja usar e faça login como administrador.
1. Crie um arquivo de lote que chama o arquivo `appref-ms` dentro do perfil de usuário. Use a variável de ambiente %APPDATA% para substituir C:\$1Users\$1username\$1\$1 Roaming. AppData Veja um exemplo de chamada de arquivo de lote:
```
explorer "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Company\ClickOnce.appref-ms"
```
1. Na área de trabalho do construtor de imagens, abra o Assistente de Imagens.
1. Na página **Configure Apps (Configurar aplicativos)**, selecione **Switch user (Trocar usuário)**.
1. Na guia **Local User (Usuário local)**, selecione **Template User (Usuário modelo)**.
1. Após fazer login como um usuário modelo, instale o aplicativo novamente.
1. Na área de trabalho do construtor de imagens, abra o Assistente de Imagens.
1. Na página **Configurar aplicativos**, abra o ClickOnce aplicativo para verificar se ele funciona corretamente. Após concluir o teste, escolha **Switch user (Trocar usuário)**.
1. Faça login novamente como administrador e realize as etapas necessárias no Assistente de imagens para concluir a criação da sua imagem.
## Quando me conecto ao construtor de imagens, vejo uma tela de login que pede para pressionar CTRL \$1 Alt \$1 Delete para fazer login. Mas a máquina local intercepta os toques do teclado.
O cliente pode interceptar localmente determinadas combinações de teclas, em vez de enviá-las para a sessão do construtor de imagens. Para enviar a combinação de teclas Ctrl\$1Alt\$1Delete de maneira confiável ao construtor de imagens, escolha **Admin Commands (Comandos do administrador)**, **Send Ctrl\$1Alt\$1Delete (Enviar Ctrl\$1Alt\$1Delete)**. O menu **Admin Commands** está disponível no canto superior direito da barra de ferramentas da sessão do construtor de imagens.
## Quando alternei entre os modos admin e teste, vi uma solicitação de senha. Não sei como obter uma senha.
WorkSpaces Os aplicativos geralmente conectam você ao modo de usuário que você escolhe automaticamente. Em algumas ocasiões, essa troca pode não ocorrer automaticamente. Se for solicitada uma senha, escolha **Admin Commands**, **Log me in**. Essa ação envia seguramente uma senha de uso único ao seu construtor de imagens e cola essa senha no campo **Password**.
## Recebo um erro quando adiciono meu aplicativo instalado.
Verifique se o tipo de aplicativo é compatível. Você pode adicionar aplicativos dos tipos `.exe`, `.lnk` e `.bat`.
Verifique se o aplicativo está instalado na hierarquia de pastas de `C:\Users`. Nenhum aplicativo instalado em `C:\Users` tem suporte. Selecione uma pasta de instalação diferente em `C:\` ao instalar o aplicativo.
## Saí acidentalmente de um serviço em segundo plano no construtor de imagens e me desconectei. Agora não consigo me conectar ao construtor de imagens.
Tente finalizar o construtor de imagens, reiniciando e conectando-se novamente. Se o problema persistir, você deverá iniciar (criar) um novo construtor de imagens. Não interrompa nenhum serviço em execução em segundo plano na instância do construtor de imagens. Se fizer isso, pode haver interrupção na sessão de seu construtor de imagens ou na interface com a criação de imagem.
## O aplicativo não inicia no modo de teste.
Verifique se o aplicativo exige privilégios de usuário elevados ou usa permissões especiais que geralmente são oferecidas somente ao administrador. O modo de teste do Image Builder tem as mesmas permissões limitadas na instância do construtor de imagens que seus usuários finais têm em uma frota de testes de WorkSpaces aplicativos. Se seus aplicativos exigirem permissões elevadas, eles não iniciarão no modo Image Builder Test.
## O aplicativo não conseguiu se conectar a um recurso de rede em minha VPC.
Verifique se o construtor de imagens foi executado na sub-rede VPC correta. É provável que você também precise verificar se as tabelas de rotas em sua VPC estão configuradas para permitir uma conexão.
## Personalizo a área de trabalho do meu construtor de imagens, mas as alterações não estão disponíveis quando me conecto a uma sessão depois de iniciar uma frota na imagem que criei.
As alterações salvas como parte de uma sessão de usuário local, como configurações de tempo, não são mantidas ao criar uma imagem. Para manter todas as alterações locais na sessão de usuário, adicione às alterações uma política de grupo local na instância do construtor de imagens.
## Ao iniciar meu aplicativo, falta um parâmetro de linha de comando.
Você pode fornecer um parâmetro de linha de comando ao usar o construtor de imagens para adicionar um aplicativo a uma imagem. Se os parâmetros de inicialização do aplicativo não se alterarem para cada usuário, você pode inseri-los ao adicionar um aplicativo à imagem na instância do construtor de imagens.
Se os parâmetros de inicialização forem diferentes para cada inicialização, você pode passá-los programaticamente ao usar a API `CreateStreamingURL`. Defina os parâmetros `sessionContext` e `applicationID` nos campos de API. O parâmetro sessionContext está incluído como uma opção de linha de comando na inicialização do aplicativo.
Se houver necessidade de calcular os parâmetros de inicialização instantaneamente, é possível iniciar o aplicativo usando um script. Você pode analisar o parâmetro `sessionContext` em seu script antes de iniciar o aplicativo com um parâmetro calculado.
## Não consigo usar minha imagem com uma frota depois que instalo um aplicativo antivírus.
Você pode instalar qualquer ferramenta, incluindo programas antivírus, em sua pilha de WorkSpaces aplicativos usando o criador de imagens antes de criar uma imagem. No entanto, esses programas não devem bloquear nenhuma porta de rede nem interromper nenhum processo usado pelo serviço de WorkSpaces aplicativos. É recomendável testar seu aplicativo no modo Image Builder Test antes de criar uma imagem e de tentar usá-la com uma frota.
## Não consegui criar uma imagem.
Verifique se você não fez nenhuma alteração nos serviços de WorkSpaces aplicativos antes de iniciar a criação da imagem. Tente criar sua imagem novamente. Se não conseguir, entre em contato com o AWS Support. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).
## A `create-image` operação do Assistente de Imagem falhou com uma mensagem de erro informando que o acesso ao PrewarmManifest .txt foi negado
O manifesto de otimização do aplicativo foi criado com privilégios elevados. Para criar a imagem, execute uma das seguintes ações e tente novamente:
+ Execute o arquivo executável (Image-Assistant.exe) da interface de linha de comando (CLI) do Image Assistant com privilégios de administrador.
+ Exclua o arquivo de manifesto de otimização do aplicativo.