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á.
# Administre suas imagens de WorkSpaces aplicativos da Amazon
As imagens disponíveis são listadas no **Registro de imagens** no console de WorkSpaces aplicativos e categorizadas por visibilidade da seguinte forma:
+ **Público** — Imagens básicas que são de propriedade e disponibilizadas por AWS. As imagens básicas incluem o sistema operacional Windows mais recente e o software do agente WorkSpaces Applications. Você pode usar essas imagens de base para criar novas imagens que incluam seus próprios aplicativos. Para obter informações sobre as imagens básicas divulgadas pela AWS, consulte[WorkSpaces Notas de versão do Applications Base Image e Managed Image Update](base-image-version-history.md).
+ **Privado** — Imagens que você cria e possui e que não compartilhou com outras AWS contas.
+ **Compartilhado com outras pessoas** — Imagens que você cria e possui e que você compartilhou com uma ou mais AWS contas na mesma AWS região. Ao compartilhar uma imagem com outra AWS conta, você pode especificar se a imagem pode ser usada para um construtor de imagens (para criar uma nova imagem), para uma frota ou ambos.
+ **Compartilhado comigo** — Imagens criadas e de propriedade de outra AWS conta na mesma AWS região e que são compartilhadas com sua AWS conta. Dependendo das permissões que o dono forneceu ao compartilhar a imagem com sua conta, você pode usar essa imagem para criadores de imagem, para frotas, ou ambos.
**Topics**
+ [Excluir uma imagem privada nos WorkSpaces aplicativos da Amazon](delete-private-image.md)
+ [Copie uma imagem que você possui para outra AWS região nos WorkSpaces aplicativos da Amazon](copy-image-different-region.md)
+ [Compartilhe uma imagem que você possui com outra AWS conta nos WorkSpaces aplicativos da Amazon](share-image-with-another-account.md)
+ [Pare de compartilhar uma imagem que você possui nos WorkSpaces aplicativos da Amazon](stop-sharing-image-with-all-accounts.md)
+ [Mantenha a imagem de seus WorkSpaces aplicativos da Amazon Up-to-Date](keep-image-updated.md)
+ [Windows Update e software antivírus nos WorkSpaces aplicativos da Amazon](windows-update-antivirus-software.md)
+ [Crie programaticamente uma nova imagem nos aplicativos da Amazon WorkSpaces](create-image-programmatically.md)
+ [Gerencie aplicativos com licença incluída em sua imagem nos WorkSpaces aplicativos da Amazon](license-included-applications.md)
+ [Importar imagem](import-image.md)
+ [Exportar imagem](export-image.md)
# Excluir uma imagem privada nos WorkSpaces aplicativos da Amazon
Você pode excluir suas imagens privadas quando não precisar mais delas. Você não pode excluir uma imagem usada por frotas ou compartilhada com outras AWS contas. Para excluir uma imagem usada por frotas ou compartilhada, você primeiro deve remover a imagem de quaisquer frotas e remover todas as permissões de compartilhamento da imagem. Depois de excluir uma imagem, você não pode recuperá-la.
**Para excluir uma imagem privada**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem privada que você deseja excluir.
1. Escolha **Ações** e **Excluir**, depois selecione **Excluir** novamente.
A imagem é removida do registro de imagens e excluída.
# Copie uma imagem que você possui para outra AWS região nos WorkSpaces aplicativos da Amazon
**Importante**
Para as regiões da AWS da Ásia-Pacífico (Malásia), Europa (Milão), Europa (Espanha) e Israel (Tel Aviv): a cópia de imagens entre regiões só é compatível WorkSpaces com imagens com versões do Applications Agent on/after lançadas em 02 de outubro de 2025 ou imagens usando atualizações gerenciadas on/after lançadas em 05 de setembro de 2025. As versões mais antigas não são elegíveis para cópia entre regiões. Atualize suas imagens para atender a esses requisitos mínimos de versão e habilitar a funcionalidade de cópia entre regiões.
Você pode copiar imagens que você possui para outra AWS região. Usar a mesma imagem em diferentes AWS regiões pode ajudar a simplificar as implantações globais de seus aplicativos em WorkSpaces aplicativos. Ao implantar seus aplicativos nas AWS regiões geograficamente mais próximas de seus usuários, você pode ajudar a fornecer aos usuários uma experiência mais responsiva.
**Para copiar uma imagem que você possui para outra AWS região**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem que você deseja copiar para outra AWS região.
1. Selecione **Actions** (Ações) e **Copy** (Copiar).
1. Na caixa de diálogo **Copiar imagem**, em **Região de destino**, selecione a AWS região para a qual você deseja copiar a imagem.
1. Digite um nome único e, opcionalmente, uma descrição para a imagem em **Destination region (Região de destino)**.
1. Escolha **Copy Image (Copiar imagem)**.
# Compartilhe uma imagem que você possui com outra AWS conta nos WorkSpaces aplicativos da Amazon
WorkSpaces As imagens dos aplicativos são um recurso regional, então você pode compartilhar uma imagem que você possui com outras AWS contas na mesma AWS região. Fazer isso pode ser útil em vários cenários diferentes. Por exemplo, se você separar seus recursos de desenvolvimento e produção usando AWS contas diferentes, poderá criar uma imagem usando sua conta de desenvolvimento. Em seguida, você pode compartilhar a imagem com sua conta de produção. Se sua organização for um provedor independente de software, você pode compartilhar imagens otimizadas com seus clientes. Imagens otimizadas que têm os aplicativos necessários já instalados e configurados permitem que os consumidores comecem a usar seus aplicativos rapidamente, para que não precisem instalar e configurar esses aplicativos pessoalmente.
Ao compartilhar uma imagem com outra AWS conta, você especifica se a conta de destino pode usar a imagem em uma frota ou criar novas imagens criando um construtor de imagens. As imagens que você compartilha continuam sendo suas. Dessa forma, você pode adicionar, alterar ou remover permissões conforme necessário para suas imagens compartilhadas.
Se você compartilhar uma imagem com uma conta e conceder à conta permissões de frota, a imagem compartilhada poderá ser usada para criar ou atualizar frotas nessa conta. Se você remover essas permissões posteriormente, a conta não poderá mais usar a imagem. Para frotas na conta que usam a imagem compartilhada, a capacidade desejada é definida como 0, o que impede que instâncias da nova frota sejam criadas. Sessões existentes continuam até que a sessão de streaming seja finalizada. Para novas instâncias de frota serem criadas, a frota nessa conta deve ser atualizada com uma imagem válida.
Se você compartilhar uma imagem com uma conta e conceder à conta permissões de criação de imagem, a imagem compartilhada poderá ser usada para gerar criadores de imagem e imagens nessa conta. Se você remover essas permissões posteriormente, os criadores de imagem e imagens que você criou a partir de sua imagem não serão afetados.
**Importante**
Depois de compartilhar uma imagem com uma conta, você não pode controlar criadores de imagem ou imagens na conta que foram criados a partir de sua imagem. Por isso, ofereça permissões de criação de imagem a uma conta apenas se quiser permitir que a conta faça uma cópia de sua imagem, e reter acesso de cópia após interromper o compartilhamento de sua imagem.
**Para compartilhar uma imagem que você possui com outra AWS conta**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem que você deseja compartilhar.
1. Escolha **Actions (Ações)**, **Share (Compartilhar)**.
1. Na caixa de diálogo **Share image (Compartilhar imagem)**, escolha **Add account (Adicionar conta)**.
1. Digite o ID de 12 dígitos AWS da conta com a qual você deseja compartilhar a imagem e, em seguida, selecione se a conta pode executar uma das seguintes ações ou ambas:
+ Usar a imagem para iniciar o criador de imagem, se você desejar criar uma nova imagem.
+ Usar a imagem com uma frota.
Para remover uma conta da lista de contas com as quais a imagem é compartilhada, na linha da conta que você deseja remover, escolha o ícone de X à direita da opção **Use for fleet (Usar para frota)**.
1. Para compartilhar a imagem com mais AWS contas, repita a etapa 6 para cada conta com a qual você deseja compartilhar a imagem.
1. Escolha **Share Image (Compartilhar imagem)**.
**Para adicionar ou atualizar as permissões de compartilhamento de imagem de uma imagem que pertence a você.**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem da qual você deseja alterar as permissões.
1. Abaixo da lista de imagens, escolha a guia **Permissions (Permissões)** da imagem selecionada, depois escolha **Edit (Editar)**.
1. Na caixa de diálogo **Editar permissões de imagem**, selecione ou desmarque uma ou ambas as opções de compartilhamento de imagem a seguir conforme necessário para uma ou mais AWS contas. Se você desmarcar as duas opções de uma conta, a imagem não será mais compartilhada com essa conta.
+ Usar a imagem para iniciar o criador de imagem, se você desejar criar uma nova imagem.
+ Usar a imagem com uma frota.
Para remover uma conta da lista de contas com as quais a imagem é compartilhada, na linha da conta que você deseja remover, escolha o ícone de X à direita da opção **Use for fleet (Usar para frota)**.
1. Para editar as permissões de compartilhamento de imagens para mais AWS contas, repita a etapa 5 para cada conta para a qual você deseja atualizar as permissões.
1. Escolha **Update image sharing permissions (Atualizar permissões de compartilhamento de imagem)**.
# Pare de compartilhar uma imagem que você possui nos WorkSpaces aplicativos da Amazon
Siga estas etapas para parar de compartilhar uma imagem que você possui com qualquer outra AWS conta.
**Para parar de compartilhar uma imagem que você possui com qualquer outra AWS conta**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem da qual você deseja alterar as permissões.
1. Abaixo da lista de imagens, escolha a guia **Permissions (Permissões)** da imagem selecionada, depois escolha **Edit (Editar)**.
1. Na caixa de diálogo **Editar permissões de imagem**, na linha de todas as AWS contas com as quais a imagem é compartilhada, escolha o ícone X à direita da opção **Usar para frota**.
1. Escolha **Update image sharing permissions (Atualizar permissões de compartilhamento de imagem)**.
# Mantenha a imagem de seus WorkSpaces aplicativos da Amazon Up-to-Date
Você pode manter a imagem de seus WorkSpaces aplicativos up-to-date fazendo o seguinte:
+ [Atualizar uma imagem usando atualizações de imagem de WorkSpaces aplicativos gerenciados](keep-image-updated-managed-image-updates.md)— Esse método de atualização fornece as atualizações mais recentes do sistema operacional e do driver, além do software mais recente do agente de WorkSpaces aplicativos.
+ [Atualize o WorkSpaces software do Agente de Aplicativos usando as versões do Agente de WorkSpaces Aplicativos Gerenciados](keep-image-updated-manage-image-versions.md)— Esse método de atualização fornece o software mais recente do agente de WorkSpaces aplicativos.
# Atualizar uma imagem usando atualizações de imagem de WorkSpaces aplicativos gerenciados
WorkSpaces Os aplicativos fornecem uma maneira automatizada de atualizar sua imagem com as atualizações mais recentes do sistema operacional, atualizações de aplicativos incluídas na licença, atualizações de drivers e software do agente de WorkSpaces aplicativos. Com as atualizações de imagens de WorkSpaces aplicativos gerenciados, você seleciona a imagem que deseja atualizar. WorkSpaces Os aplicativos criam um criador de imagens na mesma AWS conta e região para instalar as atualizações e criar a nova imagem. Depois que a nova imagem for criada, você poderá testá-la em uma frota de pré-produção antes de atualizar suas frotas de produção ou compartilhar a imagem com outras AWS contas.
**nota**
O Managed WorkSpaces Applications Image Updates está disponível para os sistemas operacionais Microsoft Windows Server, Red Hat Enterprise Linux e Rocky Linux.
**nota**
Depois que sua nova imagem for criada, você será responsável por manter as atualizações do sistema operacional. Para fazer isso, você pode continuar usando atualizações de imagens de WorkSpaces aplicativos gerenciados.
Você é responsável por manter as atualizações do driver Amazon EC2 Windows Paravirtual (PV), do driver ENA e do driver. AWS NVMe Para obter mais informações sobre como atualizar os drivers, consulte [Gerenciar drivers de dispositivo para sua instância do EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html).
Você também é responsável por manter as aplicações e suas dependências. Para adicionar outros aplicativos, atualizar aplicativos existentes ou alterar as configurações de imagem, você deve iniciar e se reconectar ao criador de imagens que você usou para criar a imagem. Alternativamente, se você excluiu o construtor de imagens, inicialize um novo construtor baseado na sua imagem. Depois, realize suas alterações e crie uma nova imagem.
## Pré-requisitos
A seguir estão os pré-requisitos e as considerações para trabalhar com atualizações de imagens gerenciadas.
+ Certifique-se de que as cotas da sua conta de WorkSpaces aplicativos (também chamadas de limites) sejam suficientes para dar suporte à criação de um novo criador de imagens e de uma nova imagem. Para solicitar um aumento de cota, você pode usar o console Service Quotas em. [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) Para obter informações sobre as cotas padrão de WorkSpaces aplicativos, consulte[Quotas do Amazon WorkSpaces Applications Service](limits.md).
+ É necessário ter a propriedade da imagem que você atualiza. Não é possível atualizar uma imagem que foi compartilhada com você.
+ Quando o WorkSpaces Applications cria um construtor de imagens para instalar as atualizações mais recentes do sistema operacional, as atualizações de drivers e o software do agente de WorkSpaces aplicativos e cria a nova imagem, você é cobrado pela instância do criador de imagens durante a atualização.
+ As imagens compatíveis devem ser criadas com base em uma imagem base lançada a partir de 2017-07-24T00:00:00Z.
+ Os idiomas inglês e japonês são compatíveis para exibição. Para obter mais informações, consulte [Especificar um idioma de exibição padrão](configure-default-display-language.md).
+ Use a versão mais recente do SSM Agent. Para obter informações sobre versões, consulte [WorkSpaces Notas de versão do Applications Base Image e Managed Image Update](base-image-version-history.md). Para obter informações sobre a instalação, consulte [Manually install SSM Agent on EC2 instances for Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html).
## Como atualizar uma imagem usando atualizações de imagem de WorkSpaces aplicativos gerenciados
Para atualizar uma imagem de WorkSpaces aplicativos com os patches, atualizações de drivers e software do agente de WorkSpaces aplicativos mais recentes, execute as etapas a seguir.
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem que você deseja atualizar. Verifique se a imagem está **Disponível**.
1. Selecione **Ações**, **Atualizar**.
1. Na caixa de diálogo **Atualizar imagem**, faça o seguinte:
+ Em **Novo nome da imagem**, insira um nome de imagem exclusivo na AWS conta e na região. O nome da imagem não pode começar com “Amazon”AWS, "” ou "”AppStream.
+ Em **Nome de exibição da nova imagem**, você também pode inserir um nome de exibição para a imagem.
+ Em **Descrição da nova imagem**, também é possível fornecer uma descrição para a imagem.
+ Em **Etiquetas**, você pode escolher **Adicionar etiqueta** e digitar a chave e o valor para a tag. Para adicionar mais tags, repita esta etapa. Para obter mais informações, consulte [Marcando seus recursos de WorkSpaces aplicativos da Amazon](tagging-basic.md).
1. Escolha **Atualizar imagem**.
Se sua imagem atual já estiver atualizada, uma mensagem notificará você.
1. No painel de navegação, selecione **Imagens**, **Construtor de imagens**.
1. Na lista de construtores de imagens, verifique se um novo construtor de imagens aparece com estado **Atualizando**. O nome do construtor de imagens inclui um sufixo aleatório de 10 dígitos.
O construtor de imagens tem o menor tamanho na família de instâncias que você escolheu para a nova imagem na etapa 5. Nenhuma sub-rede é especificada porque o construtor de imagens não está conectado à sua nuvem privada virtual (VPC).
1. Escolha **Registro de imagens** e verifique se sua nova imagem aparece na lista.
Enquanto a imagem estiver sendo criada, o status dela no registro de imagens do console aparecerá como **Criando**.
1. Depois que sua imagem é criada, o WorkSpaces Applications executa um processo de qualificação para verificar se a imagem funciona conforme o esperado.
Durante esse período, o construtor de imagens, que também é usado nesse processo, aparece na lista **Construtor de imagens** com o status **Qualificação pendente**.
1. Depois que o processo de qualificação for concluído com êxito, uma mensagem **Sucesso** será exibida no topo do console e o status da imagem no registro de imagens aparecerá como **Disponível**.
Além disso, o construtor de imagens criado WorkSpaces pelos aplicativos é excluído automaticamente.
**nota**
Dependendo do volume de atualizações do sistema operacional, pode levar várias horas para que uma atualização de imagem seja concluída. Se um problema impedir que a imagem seja atualizada, um ícone vermelho com um ponto de exclamação aparecerá ao lado do nome da imagem e o status da imagem no registro da imagens aparecerá como **Falha**. Se isso ocorrer, selecione a imagem, escolha a guia **Notificações** e analise as notificações de erro. Para obter mais informações, consulte as informações na seção [Serviço interno de imagem](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image) da documentação para conferir os códigos de notificação para solução de problemas.
Se o processo de qualificação não for bem-sucedido, o criador de imagens criado WorkSpaces pelos aplicativos ainda será excluído automaticamente.
1. Depois que o WorkSpaces Applications criar a nova imagem, teste a imagem em uma frota de pré-produção. Depois de verificar se seus aplicativos funcionam conforme o esperado, atualize a frota de produção com a nova imagem.
# Atualize o WorkSpaces software do Agente de Aplicativos usando as versões do Agente de WorkSpaces Aplicativos Gerenciados
WorkSpaces O Applications fornece uma maneira automatizada de atualizar seu criador de imagens com o software WorkSpaces Applications Agent mais recente. Isso permite que você crie uma nova imagem sempre que uma nova versão do agente for lançada. Em seguida, você pode testar a imagem antes de atualizar suas frotas de produção. Para obter mais informações sobre como gerenciar o software do agente de WorkSpaces aplicativos, consulte[Gerenciar versões do WorkSpaces Applications Agent](base-images-agent.md).
**nota**
Você é responsável por instalar e manter as atualizações do sistema operacional Windows, suas aplicações e suas dependências.
Para manter sua imagem de WorkSpaces aplicativos atualizada com as atualizações mais recentes do sistema operacional Windows, faça o seguinte:
+ Instale seus aplicativos na imagem de base mais recente sempre que uma nova imagem for lançada.
+ Instale as atualizações do sistema operacional Windows, dos aplicativos e de suas dependências em um criador de imagens existente.
+ Instale as atualizações do sistema operacional Windows, dos aplicativos e de suas dependências em um novo criador de imagens a partir de uma imagem existente.
Depois de criar uma nova imagem com o sistema operacional Windows mais recente, os aplicativos e suas dependências e o software do agente de WorkSpaces aplicativos, teste a imagem em uma frota de desenvolvimento. Depois de verificar se seus aplicativos funcionam conforme o esperado, atualize a frota de produção com a nova imagem.
# Windows Update e software antivírus nos WorkSpaces aplicativos da Amazon
WorkSpaces As instâncias de streaming de aplicativos não são persistentes. Quando uma sessão de streaming de usuários termina, o WorkSpaces Applications encerra a instância usada pela sessão e, dependendo de suas políticas de escalabilidade, provisiona uma nova instância para substituí-la em sua frota. Todas as instâncias de frota são provisionadas da mesma imagem. Como as imagens não podem ser alteradas após a criação, todas as instâncias de frota usadas em sessões de streaming do usuário têm apenas as atualizações do Windows e de aplicativos que foram instaladas na imagem subjacente quando a imagem foi criada. Além disso, como uma instância de frota usada para uma sessão de streaming é encerrada no final da sessão, todas as atualizações feitas no Windows ou em aplicativos na instância durante a sessão de streaming não persistirão em sessões futuras do mesmo usuário ou de outros usuários.
**nota**
Se você ativou a persistência das configurações do aplicativo para sua pilha, o WorkSpaces Applications persiste o Windows e as alterações de configuração do aplicativo feitas por um usuário em futuras sessões do mesmo usuário, se essas alterações de configuração forem armazenadas no perfil do Windows do usuário. No entanto, o recurso de persistência de configurações de aplicativos se aplica somente às definições de configuração do Windows e de aplicativo. Ele não mantém atualizações de software para o Windows ou aplicativos na instância de streaming.
Por esses motivos, o WorkSpaces Applications adota a seguinte abordagem para o Windows Update e o software antivírus em instâncias de WorkSpaces aplicativos.
## Atualizações do Windows
O Windows Update não está habilitado por padrão nas imagens base de WorkSpaces aplicativos. Se você habilitar o Windows Update em um construtor de imagens e tentar criar uma imagem, o Assistente de imagens exibirá um aviso e desabilitará o Windows Update durante o processo de criação da imagem. Para garantir que as instâncias de frota tenham as atualizações mais recentes do Windows instaladas, recomendamos instalar as atualizações do Windows no construtor de imagens, criar uma nova imagem e atualizar sua frota com a nova imagem regularmente.
## Software antivírus
Se você optar por instalar o software antivírus em sua imagem, recomendamos não habilitar as atualizações automáticas para o software antivírus. Caso contrário, o software antivírus poderá tentar se atualizar com os arquivos de definição mais recentes ou outras atualizações durante sessões de usuário. Isso pode afetar o desempenho. Além disso, todas as atualizações feitas no software antivírus não persistirão além da sessão do usuário atual. Para garantir que as instâncias de frota sempre tenham as atualizações antivírus mais recentes, recomendamos executar uma das seguintes ações:
+ Atualize o construtor de imagens e crie uma nova imagem regularmente (por exemplo, usando as [operações da CLI do Assistente de imagens](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)).
+ Use um aplicativo antivírus que delegue a verificação ou outras operações a um servidor always-up-to-date externo.
**nota**
Mesmo que você não habilite atualizações automáticas para o software antivírus, ele pode executar verificações no disco rígido ou outras operações que podem afetar o desempenho das instâncias de frota durante sessões do usuário.
Nas imagens base de WorkSpaces aplicativos Windows Server 2025/2022/2019/2016 publicadas em ou após 10 de setembro de 2019, o Windows Defender não está habilitado por padrão. Nas imagens base dos WorkSpaces Aplicativos Windows Server 2016 e Windows Server 2019 publicadas em 24 de junho de 2019, o Windows Defender está habilitado por padrão.
**Como ativar o Windows Defender manualmente**
Se o Windows Defender não estiver ativado na imagem base, será possível ativá-lo manualmente. Para fazer isso, execute as etapas a seguir:
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação esquerdo, selecione **Images (Imagens)**, **Image Builder (Criador de imagens)**.
1. Escolha o criador de imagens no qual ativar o Windows Defender, verifique se ele está no estado **Running (Em execução)** e selecione **Connect (Conectar)**.
1. Faça login no construtor de imagens com a conta **Administrador** local ou com uma conta de domínio com permissões de administrador local.
1. Abra o Editor de Registro.
1. Navegue até o seguinte local no registro: **HKLM\$1 SOFTWARE\$1 Policies\$1 Microsoft\$1 Windows Defender\$1**. DisableAntiSpyware
1. Para editar essa chave de registro, clique duas vezes nela ou clique com o botão direito do mouse na chave de registro e selecione **Modify (Modificar)**.
1. Na caixa de diálogo **Edit DWORD (32-bit) Value (Editar valor DWORD (32 bits))**, em **Value data (Dados do valor)**, altere **1** para **0**.
1. Escolha **OK**.
1. Feche o Editor de Registro.
1. Abra o snap-in **Services (Serviços)** do Console de Gerenciamento Microsoft (MMC) (`services.msc`).
1. Na lista de serviços, siga um destes procedimentos.
Se você estiver usando o Microsoft Windows Server 2022/2025, faça o seguinte:
+ Clique com o botão direito em **Microsoft Defender Antivirus Service (Serviço de antivírus do Microsoft Defender)** e selecione **Start (Iniciar)**.
+ Clique duas vezes em **Microsoft Defender Antivirus Service (Serviço de antivírus do Microsoft Defender)**, selecione **Start (Iniciar)** na caixa de diálogo de propriedades e selecione **OK**.
Se estiver usando o Microsoft Windows Server 2019 ou 2016, escolha uma das opções a seguir:
+ Clique com o botão direito do mouse em **Windows Defender Antivirus Service (Serviço de antivírus do Windows Defender)** e selecione **Start (Iniciar)**.
+ Clique duas vezes em **Windows Defender Antivirus Service (Serviço de antivírus do Windows Defender)**, selecione **Start (Iniciar)** na caixa de diálogo de propriedades e selecione **OK**.
1. Feche o snap-in **Services (Serviços)**.
# Crie programaticamente uma nova imagem nos aplicativos da Amazon WorkSpaces
Você pode criar imagens de WorkSpaces aplicativos programaticamente conectando-se a um construtor de imagens e usando as operações da interface de linha de comando (CLI) do Image Assistant. Para obter mais informações, consulte [Crie sua imagem de WorkSpaces aplicativos da Amazon de forma programática usando as operações de CLI do Image Assistant](programmatically-create-image.md).
# Gerencie aplicativos com licença incluída em sua imagem nos WorkSpaces aplicativos da Amazon
Você pode transmitir os seguintes aplicativos incluídos na licença da Microsoft usando WorkSpaces Aplicativos. Você pode instalar esses aplicativos em sua imagem do Windows, usar essa imagem personalizada para criar frotas e, em seguida, transmitir esses aplicativos. Todos os aplicativos a seguir estão disponíveis na arquitetura de 32 e 64 bits.
+ Microsoft Office LTSC Professional Plus 2021/2024
+ Microsoft Visio LTSC Professional 2021/2024
+ Microsoft Project Professional 2021/2024
+ Padrão LTSC do Microsoft Office 2021/2024
+ Padrão Microsoft Visio LTSC 2021/2024
+ Padrão do Microsoft Project 2021/2024
**Importante**
O Microsoft Office, Visio e Project devem seguir as mesmas versões. Por exemplo, você não pode misturar aplicativos de 2021 com aplicativos de 2024.
O Microsoft Office, Visio e Project devem seguir a mesma arquitetura. Por exemplo, você não pode misturar aplicativos de 32 bits com aplicativos de 64 bits.
As Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/Professional versões Microsoft Office, Visio e Project 2021 são suportadas no Microsoft Windows Server 2022 e 2025.
Para habilitar esse recurso, você deve usar um WorkSpaces Applications Image Builder que usa um agente de WorkSpaces aplicativos lançado em ou após 2 de outubro de 2025. Para obter mais informações, consulte [Gerenciar versões do WorkSpaces Applications Agent](base-images-agent.md). Ou sua imagem deve usar atualizações de imagem de WorkSpaces aplicativos gerenciados lançadas em ou após 3 de outubro de 2025. Para obter mais informações, consulte [Mantenha a imagem de seus WorkSpaces aplicativos da Amazon Up-to-Date](keep-image-updated.md).
O TCP de saída na porta 1688 deve estar aberto na interface de rede de gerenciamento de todas as instâncias de streaming.
Todos os usuários que fazem streaming por meio de uma frota alimentada por uma imagem com um ou mais aplicativos licenciados são cobrados mensalmente por esses aplicativos, independentemente do uso. O atributo de autorização do aplicativo não restringe o acesso de usuários específicos.
Os aplicativos incluídos na licença no criador de imagem não são ativados porque são instalados para fins administrativos. A ativação ocorre quando os usuários fazem streaming por meio de uma instância de frota.
**Topics**
+ [Ver a lista de aplicativos incluídos na licença instalados em sua imagem](view-list-image.md)
+ [Ver a lista de aplicativos incluídos na licença instalados em seu criador de imagem](view-list-apps.md)
+ [Instalar ou desinstalar aplicativos incluídos na licença](install-uninstall-apps.md)
+ [Habilitar atualizações para aplicativos incluídos na licença no criador de imagens](updates-image-builder.md)
+ [Habilite atualizações para aplicativos incluídos na licença no criador de imagens com o PowerShell](enable-updates-managed-powershell.md)
+ [Habilitar atualizações para aplicativos incluídos na licença no criador de imagens com atualização de imagem gerenciada](enable-updates-managed.md)
# Ver a lista de aplicativos incluídos na licença instalados em sua imagem
**Ver a lista de aplicativos incluídos na licença instalados em sua imagem**
Para ver a lista de aplicativos incluídos na licença instalados em sua imagem, siga essas etapas.
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Escolha **Imagens** no painel de navegação esquerdo e na guia **Registro de imagens**.
1. Selecione uma imagem e escolha **Exibir detalhes**.
1. Revise a lista de todos os aplicativos instalados em **Aplicativos incluídos na licença**.
# Ver a lista de aplicativos incluídos na licença instalados em seu criador de imagem
**Ver a lista de aplicativos incluídos na licença instalados em seu criador de imagem**
Para ver a lista de aplicativos licenciados incluídos em seu criador de imagens, siga estas etapas.
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação esquerdo, selecione **Images (Imagens)** e a guia **Image Builder (Criador de imagens)**.
1. Selecione um criador de imagens e escolha **View details (Exibir detalhes)**.
1. Revise a lista de aplicativos e seus status em **License included applications (Aplicativos incluídos na licença)**.
# Instalar ou desinstalar aplicativos incluídos na licença
**Instalar ou desinstalar aplicativos incluídos na licença**
Para instalar ou desinstalar um ou mais aplicativos incluídos na licença em sua imagem, siga estas etapas.
1. Conclua uma das seguintes opções:
+ Inicie um criador de imagens e configure os aplicativos incluídos na licença. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).
+ Gerencie aplicativos incluídos na licença em seu criador de imagens. Para obter mais informações, consulte [Direitos de aplicação baseados em atributos usando um provedor de identidades SAML 2.0 de terceiros](application-entitlements-saml.md).
1. Quando você tem uma imagem criada com um ou mais aplicativos incluídos na licença, você pode usar essa imagem para criar frotas. Os usuários que se conectam a essa frota podem acessar esses aplicativos.
**Importante**
Todos os usuários que fazem streaming por meio de uma frota alimentada por uma imagem com um ou mais aplicativos licenciados serão cobrados mensalmente por esses aplicativos, independentemente do uso. O atributo de autorização do aplicativo não restringe o acesso de usuários específicos.
Se você encontrar falhas durante a instalação ou desinstalação do aplicativo incluído na licença, verá um status de falha na página de detalhes do seu criador de imagem. Para solucionar esses problemas, recomendamos conectar-se ao criador de imagem e ativar o registro detalhado. Para obter mais informações, consulte [Como habilitar os aplicativos do Microsoft 365 para registro corporativo](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging). Se o problema persistir após a análise dos registros e a solução de problemas, entre em contato AWS Support para obter ajuda.
# Habilitar atualizações para aplicativos incluídos na licença no criador de imagens
**Habilitar atualizações para aplicativos incluídos na licença no criador de imagens**
As atualizações para todos os aplicativos incluídos na licença estão desativadas por padrão. Você pode habilitar atualizações para esses aplicativos no criador de imagens com uma imagem que inclua um ou mais desses aplicativos. As atualizações nas instâncias da frota permanecem desativadas para impedir a instalação durante a configuração da sessão.
Há três opções para habilitar atualizações para aplicativos incluídos na licença no criador de imagens.
Para habilitar atualizações para aplicativos incluídos na licença no criador de imagens com o menu do aplicativo, siga estas etapas.
1. Abra qualquer aplicativo incluído na licença.
1. Escolha **Arquivo**, **Conta**, **Opções de atualização** e **Ativar atualizações**.
# Habilite atualizações para aplicativos incluídos na licença no criador de imagens com o PowerShell
Para habilitar atualizações para aplicativos incluídos na licença no construtor de imagens com o PowerShell, siga estas etapas.
+ Execute o seguinte comando PowerShell como administrador:
`Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `
# Habilitar atualizações para aplicativos incluídos na licença no criador de imagens com atualização de imagem gerenciada
Para habilitar atualizações para aplicativos incluídos na licença no criador de imagens com atualização de imagem gerenciada, siga essas etapas.
+ Use a atualização de imagem gerenciada para receber atualizações sobre os aplicativos incluídos na licença da Microsoft. Para obter mais informações, consulte .
[Atualizar uma imagem usando atualizações de imagem de WorkSpaces aplicativos gerenciados](keep-image-updated-managed-image-updates.md).
# Importar imagem
Você pode criar imagens de WorkSpaces aplicativos importando suas imagens personalizadas EC2 AMIs. Como isso funciona:
1. Personalize sua EC2 AMI usando qualquer método preferido, incluindo o [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).
1. Importe sua AMI personalizada em WorkSpaces aplicativos para criar uma imagem de WorkSpaces aplicativos
1. Opcionalmente, use o Image Builder para personalização adicional de imagens
As imagens criadas por meio da importação da AMI são de`type = "custom"`, enquanto as imagens fornecidas pelos WorkSpaces aplicativos são de`type = "native"`.
Você pode usar tipos de instância stream.\$1 para imagens com. `type = "native"` Para usar qualquer um dos seguintes tipos de instância, você deve importar sua AMI e criar uma imagem com`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Acelerado. \$1
## Pré-requisitos para importação de imagens
Todos esses pré-requisitos são importantes para uma execução bem-sucedida do fluxo de trabalho. As configurações de AMI suportadas e outros requisitos obrigatórios estão listados abaixo.
### Propriedades obrigatórias da AMI
EBS
+ Tamanho menor ou igual a 500 GB
+ Você pode importar uma AMI com < 200 GB, no entanto, a imagem importada usará no mínimo 200 GB.
+ GP2
+ Você pode importar uma AMI com o tipo de volume EBS gp2 ou gp3, no entanto, a imagem importada usará gp2.
+ Um volume por imagem
+ `/dev/sda1`Nome do dispositivo raiz
+ Tipo de imagem: Máquina
+ Arquitetura: x86\$164
+ Tipo de virtualização: HVM
+ Modo de inicialização: UEFI
+ Suporte ao TPM: v2.0. Isso é necessário. Consulte [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1 para encontrar uma AMI habilitada para TPM. ami-windows-tpm-find](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find)
+ Suporte da ENA: verdadeiro
+ Plataforma: Windows
+ Detalhes da plataforma: Windows
### Propriedades do sistema operacional
**Base completa do Windows Server 2022/2025**
+ O Windows Server **Core** não é suportado
+ O Windows com SQL Server não é suportado
Agentes
+ EC2 Inicie a versão V2 >= 2.1.1
+ Agente SSM obrigatório
Drivers
+ EC2 Versão do driver ENA >= 2.9.0
+ EC2 NVMe Versão do driver >= 1.6.0
Library Support
+ .NET Framework 4.8 ou superior
+ Instalado por padrão no Windows Server 2022/2025
+ PowerShell 5.1 ou superior
+ Instalado por padrão no Windows Server 2022/2025
+ Recursos do Windows: O licenciamento de serviços de área de trabalho remota e o host da sessão de serviços de área de trabalho remota não devem ser instalados
+ Portas: as portas 8000, 8300 e 8443 devem estar desbloqueadas e desocupadas
+ Modo de inicialização: UEFI
Se você quiser usar imagens com instâncias gráficas, como Accelerated.G4DN, Accelerated.G5, Accelerated.G6 ou Accelerated.G6E, instale o driver GRID adequado em sua AMI. Para obter mais detalhes, consulte [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html). Se os drivers não estiverem configurados corretamente, o streaming funcionará, no entanto, a placa gráfica pode não estar disponível.
**Importante**
O “ID da conta do proprietário” da AMI deve ser o ID AWS da sua conta. Você não pode importar uma EC2 AMI pública.
Execute todas as atualizações do Windows e desative as atualizações automáticas do Windows antes de importar a imagem.
Atualmente, a importação de arquivos criptografados não EC2 AMIs é suportada
### Requisitos da função do IAM
**Importante**
“Crie uma função do IAM com as seguintes permissões para usar na importação de imagens:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowModifyImageAttributeWithTagCondition",
"Effect": "Allow",
"Action": "ec2:ModifyImageAttribute",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
}
]
}
```
Adicione a seguinte relação de confiança para essa função do IAM
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Para importar uma imagem
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação esquerdo, escolha **Imagens** e, em seguida, escolha **Registro de imagens**.
1. Escolha **Importar imagem**.
1. **ID da AMI** - insira uma ID da AMI para a AMI que você gostaria de importar para os WorkSpaces aplicativos. Você também pode pesquisar sua AMI usando esse campo.
1. **Nome da imagem** - insira um nome exclusivo para a imagem que será criada devido à operação de importação.
1. **Nome de exibição** *(opcional)* - insira um para exibir a imagem.
1. **Descrição** *(opcional)* — insira uma descrição para a imagem.
1. **Função do IAM** - Selecione a função do IAM que você criou para importação de imagens. Para obter mais detalhes, consulte[Requisitos da função do IAM](#iam-role-requirements).
1. **Agente de gerenciamento de WorkSpaces aplicativos** — selecione essa opção se quiser sempre usar a versão mais recente do agente de WorkSpaces aplicativos, suas instâncias de streaming serão atualizadas automaticamente com os recursos mais recentes, melhorias de desempenho e atualizações de segurança disponíveis a partir do AWS lançamento de uma nova versão do agente.
1. **Validação de tempo de execução** *(opcional)*: selecione essa opção e o serviço provisionará uma instância com a imagem que está sendo importada e executará testes de streaming.
+
**nota**
Esses testes de streaming serão executados em segundo plano. Você não pode se conectar a essa instância por meio do cliente WorkSpaces Applications.
+ Recomendamos usar essa opção para ter mais certeza de que sua imagem é adequada para WorkSpaces aplicativos.
+ Você será cobrado pelo preço por hora dessa instância.
+ Você pode evitar a execução da validação do tempo de execução se estiver reimportando sua AMI depois de fazer pequenas alterações que talvez não afetem o teste de streaming. Se a validação do tempo de execução for aprovada pela última vez, você importou essa AMI.
+ **Escolha o tipo de instância** *(opcional)*: selecione a família, o tipo e o tamanho de instâncias corretos para executar o teste de streaming. É recomendável que você use a mesma instância que planeja usar para a criação da frota.
1. **Catálogo de aplicativos e manifesto de desempenho de lançamento** *(opcional)*: forneça detalhes para criar um catálogo de aplicativos para seus usuários finais e melhorar o desempenho de lançamento de seus aplicativos.
+ **Catálogo de aplicativos**: Para criar um catálogo de aplicativos, especifique detalhes sobre os aplicativos instalados em sua imagem. Para cada aplicativo que pretende fazer streaming, você pode especificar o nome, o nome de exibição, o arquivo executável para iniciar e o ícone para exibição.
+ **Desempenho do lançamento**: adicionar arquivos ao manifesto de otimização do aplicativo reduz o tempo necessário para que o aplicativo seja iniciado pela primeira vez em uma nova instância de frota. O manifesto de otimização é um arquivo de texto delimitado por linha que é exclusivo de cada aplicativo.
Para saber mais, consulte[Detalhes dos aplicativos](applications-details.md).
1. **Tags** *(opcional)* - escolha **Adicionar tag** e digite a chave e o valor da tag. Para adicionar mais tags, repita esta etapa. Para obter mais informações, consulte [Marcando seus recursos de WorkSpaces aplicativos da Amazon](tagging-basic.md).
1. **Importar imagem** — Revise todas as informações inseridas e escolha **Importar imagem**. O serviço executará verificações de compatibilidade para garantir que a AMI seja compatível com WorkSpaces os aplicativos.
+ Se as verificações estáticas falharem, você receberá um erro imediatamente.
+ Se as verificações estáticas forem aprovadas, sua solicitação de importação será enviada e, dependendo das opções selecionadas, poderá levar de 30 a 60 minutos para criar uma nova imagem de WorkSpaces aplicativos com `type = "custom"`
# Detalhes dos aplicativos
Os detalhes dos aplicativos contêm informações sobre manifestos pré-aquecidos e configurações do catálogo de aplicativos.
## PreWarm Manifestos de aplicativos
Ao criar imagens de WorkSpaces aplicativos, você pode especificar aplicativos a serem disponibilizados para seus usuários. Para acelerar o tempo de inicialização do aplicativo, você pode preparar um PreWarm manifesto. Isso é basicamente um catálogo dos arquivos que seu aplicativo precisa iniciar quando os usuários iniciam seu aplicativo. Durante o provisionamento da instância, esses arquivos serão preparados antes das conexões da sessão para acelerar os tempos de inicialização do aplicativo nas sessões do usuário.
Os manifestos pré-aquecidos devem ser pré-criados em sua AMI antes de serem importados para o WorkSpaces ambiente de aplicativos. Você pode escolher criar um arquivo de manifesto comum do Prewarm ou um para cada aplicativo. Isso muda a forma como você importará sua AMI posteriormente.
### Manifesto comum de pré-aquecimento
Para cada aplicativo que você deseja pré-aquecer, inicie o aplicativo e realize quaisquer interações iniciais que seus usuários possam realizar. Em seguida, use o comando a seguir direcionado ao diretório em que os dados do seu aplicativo estão armazenados.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Isso anexará os arquivos a serem otimizados para cada aplicativo no arquivo comum`C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt`. Não é necessária nenhuma ação adicional para realizar o pré-aquecimento do aplicativo. WorkSpaces Os aplicativos procurarão o arquivo de pré-aquecimento no local acima e o usarão se ele estiver presente.
Esse processo é opcional e, à medida que o tamanho do manifesto de pré-aquecimento aumenta, o tempo de provisionamento da frota também aumentará. Portanto, tenha cuidado para equilibrar a otimização com o aprovisionamento da frota.
### Manifestos específicos de aplicativos
Durante a importação da imagem, talvez você queira especificar arquivos de manifesto de aplicativo separados por aplicativo para facilitar o rastreamento dos ativos de pré-aquecimento por aplicativo. Para fazer isso, execute as mesmas etapas acima, mas em vez de criar um `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` arquivo comum, crie um arquivo por aplicativo na sua AMI.
Para cada aplicativo que você deseja pré-aquecer, inicie o aplicativo e realize quaisquer interações iniciais que seus usuários possam realizar. Em seguida, use o comando a seguir direcionado ao diretório em que os dados do seu aplicativo estão armazenados.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\PreWarm.txt" -encoding UTF8 -append
```
Usaremos esses arquivos de pré-aquecimento do aplicativo durante o processo de importação de imagens. Novamente, isso é totalmente opcional. Você pode optar por usar esse método, o método Common Prewarm Manifest ou nenhum manifesto Prewarm.
## Configurações do catálogo de aplicativos
`AppCatalogConfig`que permite especificar os aplicativos que você deseja registrar na imagem dos WorkSpaces aplicativos durante a importação da AMI. `AppCatalogConfig`É uma lista JSON de objetos de configuração de aplicativos da estrutura a seguir.
```
[
{
"Name": "Rufus", //Required and must be unique among the list of applications
"DisplayName": "Rufus",
"AbsoluteAppPath": "Rufus", //Required
"AbsoluteIconPath": "Rufus",
"AbsoluteManifestPath": "Rufus",
"WorkingDirectory": "Rufus",
"LaunchParameters": "Rufus"
}
...
// Up to 50 applications total
]
```
Os únicos campos obrigatórios por inscrição são o `Name` e `AbsoluteAppPath` o. Os detalhes de cada campo são os seguintes:
Nome [**Obrigatório**]
+ Um nome próprio para seu aplicativo para identificá-lo
+ Entre 1 e 100 caracteres
+ Caracteres permitidos (regex) `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Deve ser único em um determinado AppCatalogConfig
DisplayName
+ O nome de exibição de um determinado aplicativo para exibição aos usuários
+ Entre 0 e 100 caracteres
+ Caracteres permitidos (regex) `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`
AbsoluteAppPath [**Obrigatório**]
+ O caminho para o executável para iniciar seu aplicativo
+ Este é o executável que será lançado quando os usuários selecionarem seu aplicativo
+ Entre 1 e 32767 caracteres
+ Esse limite superior de comprimento de caracteres é para oferecer suporte a caminhos de arquivo estendidos no Windows. Certifique-se de que sua AMI e seu aplicativo estejam configurados adequadamente para oferecer suporte a caminhos de arquivo estendidos do Windows se estiver usando caminhos de arquivo maiores que 260 caracteres.
+ Use cadeias de caracteres de caminho de arquivo com escape, como
+ `"C:\\Windows\\System32\\notepad.exe"`
AbsoluteManifestPath
+ Aplicável somente se você estiver usando [Manifestos específicos de aplicativos](#application-specific-manifests)
+ Caminho para pré-aquecer o arquivo de manifesto desse aplicativo
+ Entre 0 e 32767 caracteres
+ Esse limite superior de comprimento de caracteres é para oferecer suporte a caminhos de arquivo estendidos no Windows. Certifique-se de que sua AMI e seu aplicativo estejam configurados adequadamente para oferecer suporte a caminhos de arquivo estendidos do Windows se estiver usando caminhos de arquivo maiores que 260 caracteres.
+ Use cadeias de caracteres de caminho de arquivo com escape, como
+ `"C:\\Path\\To\\PrewarmManifest.txt"`
AbsoluteIconPath
+ Caminho para o arquivo de ícone na AMI a ser usado para o aplicativo.
+ Esse ícone será exibido aos usuários ao transmitir para esta imagem.
+ Se nenhum for fornecido, o ícone será derivado do próprio executável.
+ Certifique-se de selecionar arquivos de ícones com transparência de fundo tratada adequadamente para uma boa experiência de cliente para seus usuários.
+ Use imagens PNG
+ Entre 1 e 32767 caracteres
+ Esse limite superior de comprimento de caracteres é para oferecer suporte a caminhos de arquivo estendidos no Windows. Certifique-se de que sua AMI e seu aplicativo estejam configurados adequadamente para oferecer suporte a caminhos de arquivo estendidos do Windows se estiver usando caminhos de arquivo maiores que 260 caracteres.
+ Use cadeias de caracteres de caminho de arquivo com escape, como
+ `"C:\\Path\\To\\ApplicationIcon.png"`
WorkingDirectory
+ O diretório de trabalho no qual iniciar seu aplicativo
+ Entre 0 e 32767 caracteres
+ Esse limite superior de comprimento de caracteres é para oferecer suporte a caminhos de arquivo estendidos no Windows. Certifique-se de que sua AMI e seu aplicativo estejam configurados adequadamente para oferecer suporte a caminhos de arquivo estendidos do Windows se estiver usando caminhos de arquivo maiores que 260 caracteres.
+ Use cadeias de caracteres de caminho de arquivo com escape, como
+ `"C:\\Path\\To\\Working\\Directory"`
LaunchParameters
+ Uma string a ser usada como parâmetros de inicialização para o executável especificado em `AbsoluteAppPath`
+ Entre 0 e 1024 caracteres
+ Use cadeias de caracteres de escape com a lista completa dos parâmetros de inicialização necessários, como o exemplo a seguir, que mostra como você pode usar PowerShell scripts como seus aplicativos usando o PowerShell executável como seu aplicativo com um script fornecido nos parâmetros de inicialização.
+ AbsoluteAppPath
+ `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
+ LaunchParameters
+ `"-File \"C:\\Path\\To\\App\\Script.ps1\""`
### Amostra AppCatalogConfig
Este é um exemplo básico de um AppCatalogConfig para o Notepad, Google Chrome e Mozilla Firefox
```
[
{
"Name": "Notepad",
"DisplayName": "Notepad",
"AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
},
{
"Name": "Chrome",
"DisplayName": "Chrome",
"AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
"LaunchParameters": "https://www.amazon.com/"
},
{
"Name": "Firefox",
"DisplayName": "Firefox",
"AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
"LaunchParameters": "https://aws.amazon.com/"
}
]
```
# Exportar imagem
Você pode exportar suas imagens para criar EC2 AMIs. Posteriormente, [Importar imagem](import-image.md) você pode AMIs voltar para criar imagens de WorkSpaces aplicativos. Isso ajuda você a usar suas próprias ferramentas de personalização da AMI para personalizar suas imagens.
**nota**
Durante a exportação, os seguintes componentes serão removidos de suas imagens
WorkSpaces Agente de aplicativos
A licença da Microsoft incluiu aplicativos, que foram adicionados usando o Image Builder
Somente imagens do Microsoft Windows Server 2022 e 2025 podem ser exportadas.
## Requisitos da função do IAM
**Importante**
Crie uma função do IAM com as seguintes permissões para usar na importação de exportação:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowCopyImage",
"Effect": "Allow",
"Action": "ec2:CopyImage",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
},
{
"Sid": "AllowCreateTags",
"Effect": "Allow",
"Action": "ec2:CreateTags",
"Resource": "*"
}
]
}
```
Adicione a seguinte relação de confiança para essa função do IAM
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Exportar uma imagem
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem privada que você deseja exportar.
1. Escolha **Ações**, **Exportar**.
1. Na caixa de diálogo **Exportar imagem**, digite um **nome exclusivo da AMI** e, opcionalmente, uma **descrição da AMI** para a AMI.
1. **Função do IAM** - Selecione a função do IAM que você criou para exportação de imagens.
1. Opcionalmente, você copia as tags da sua imagem para a AMI marcando a caixa de seleção **Copiar tags na exportação**.
1. Escolha **Exportar imagem**.