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á.
# Imagens
Você pode criar imagens de WorkSpaces aplicativos da Amazon que contêm aplicativos que você pode transmitir para seus usuários e configurações padrão do sistema e do aplicativo para permitir que seus usuários comecem a usar esses aplicativos rapidamente. No entanto, depois que criar uma imagem, você não poderá alterá-la. 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. Se você excluiu que criador de imagens, inicie um novo criador de imagens baseado na sua imagem. Depois, realize suas alterações e crie uma nova imagem. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md) e [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md).
As imagens que estão disponíveis para você são listadas no **Registro de imagens** no console de WorkSpaces aplicativos. Eles são categorizadas como públicos, privados ou compartilhados. Você pode usar qualquer um desses tipos de imagem para iniciar um criador de imagens e configurar uma frota de WorkSpaces aplicativos. As imagens compartilhadas pertencem a outras contas da Amazon Web Services e são compartilhadas com você. As permissões definidas em imagens que são compartilhadas com você pode limitar o que você pode fazer com as imagens. Para obter mais informações, consulte [Administre suas imagens de WorkSpaces aplicativos da Amazon](administer-images.md).
**Topics**
+ [Configurações padrão do aplicativo e do Windows e desempenho de lançamento de aplicativos nos WorkSpaces aplicativos da Amazon](customizing-appstream-images.md)
+ [Gerenciar versões do WorkSpaces Applications Agent](base-images-agent.md)
+ [WorkSpaces Notas de versão do Agente de Aplicativos](agent-software-versions.md)
+ [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md)
+ [Administre suas imagens de WorkSpaces aplicativos da Amazon](administer-images.md)
+ [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)
+ [Criar imagens baseadas em Linux](create-linux-based-images.md)
+ [Use scripts de sessão para gerenciar a experiência de streaming dos usuários de seus WorkSpaces aplicativos Amazon](use-session-scripts.md)
# Configurações padrão do aplicativo e do Windows e desempenho de lançamento de aplicativos nos WorkSpaces aplicativos da Amazon
Você pode criar configurações de aplicativo padrão e Windows para habilitar seus usuários para começar a usar seus aplicativos rapidamente, para que eles não precisem criar ou configurar as configurações por conta própria.
WorkSpaces Os aplicativos otimizam o desempenho de lançamento de seus aplicativos para as sessões de streaming de seus usuários. Para garantir que todos os arquivos necessários sejam incluídos neste processo, pode ser necessário adicionar manualmente determinados arquivos e pastas para o manifesto de otimização.
**Topics**
+ [Criando configurações padrão do aplicativo e do Windows para os usuários de seus WorkSpaces aplicativos](creating-default-app-Windows-settings.md)
+ [Otimizando o desempenho de lançamento de seus aplicativos na Amazon WorkSpaces Applications](optimizing-app-launch-performance.md)
# Criando configurações padrão do aplicativo e do Windows para os usuários de seus WorkSpaces aplicativos
As personalizações de aplicativos e as configurações do Windows que estão salvas na pasta de perfil do usuário do Windows ou o hive do registro do usuário podem ser definidos como padrões. Quando você salva as configurações padrão usando o **Usuário de Modelo** no Assistente de Imagem, os WorkSpaces Aplicativos substituem o perfil de usuário padrão do Windows pelo perfil que você configura. O perfil de usuário padrão do Windows é, então, usado para criar as configurações iniciais para os usuários na instância de frota. Se as configurações da aplicativo ou do Windows que você fizer não funcionam na frota, verifique se elas estão salvas no perfil de usuário do Windows. Para obter mais informações, consulte Etapa: 3: Criar aplicativo padrão e configurações do Windows em [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md).
As configurações padrão que você pode criar e configurar incluem:
+ Preferências de aplicativo, incluindo uma página inicial do navegador, personalizações da barra de ferramentas e configurações de segurança.
+ Configurações de dados do aplicativo, incluindo favoritos do navegador e perfis de conexão.
+ Configurações da experiência do Windows, incluindo extensões do nome de arquivo em exibição e pastas ocultas.
Além disso, você pode modificar ou desabilitar as configurações de segurança do Internet Explorer, como a Configuração de Segurança Reforçada (ESC). Para obter mais informações, consulte [Desative a configuração de segurança aprimorada do Internet Explorer nos WorkSpaces aplicativos da Amazon](customize-fleets-disable-ie-esc.md).
# Otimizando o desempenho de lançamento de seus aplicativos na Amazon WorkSpaces Applications
Quando você cria uma imagem, o WorkSpaces Applications exige que você otimize o desempenho de lançamento de seus aplicativos para as sessões de streaming de seus usuários. Quando suas aplicativos são abertas durante esse processo, certifique-se de que elas usam os componentes iniciais exigidos por seus usuários. Isso garante que esses componentes sejam capturados pelo processo de otimização. Em alguns casos, nem todos os arquivos necessários para as otimizações são detectados. Os exemplos desses arquivos seriam plug-ins ou componentes que não são abertos no criador de imagens. Para garantir que todos os arquivos necessários para o seu aplicativo sejam capturados, você pode incluí-los no manifesto de otimização. A adição de arquivos ao manifesto de otimização pode aumentar o tempo necessário para as instâncias de frota serem criadas e disponibilizadas para os usuários. Isso, no entanto, reduz o tempo necessário para o aplicativo ser iniciado pela primeira vez na instância de frota.
Para otimizar todos os arquivos em uma pasta, abra PowerShell e use o seguinte PowerShell comando:
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Por padrão, o Assistente de Imagens substitui o manifesto de otimização de aplicações sempre que a etapa **Optimize** do Assistente de Imagens é executada. Você deve executar o PowerShell comando para otimizar todos os arquivos em uma pasta:
+ Sempre que executar a etapa **Otimizar**.
+ Antes de escolher **Desconectar e criar imagem** na página **Revisar** do Assistente de Imagens.
Como alternativa, você pode especificar o manifesto de otimização para cada aplicativo usando as operações da interface de linha de comando (CLI) do Image Assistant. **Quando você especifica o manifesto de otimização usando as operações da CLI do Image Assistant, o WorkSpaces Applications mescla o manifesto de otimização do aplicativo especificado com os arquivos identificados pela etapa Image Assistant Optimize.** 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).
# Gerenciar versões do WorkSpaces Applications Agent
O agente de WorkSpaces aplicativos é um software executado em suas instâncias de streaming e permite que os usuários transmitam aplicativos. Ao criar uma nova imagem, a opção **Always use latest agent version (Sempre usar a versão de agente mais recente)** é selecionada por padrão. Quando essa opção é selecionada, novos criadores de imagens ou instâncias de frota que são iniciadas a partir da sua imagem sempre usam a versão mais recente do WorkSpaces Applications Agent. Talvez você queira controlar as atualizações do agente para garantir a compatibilidade com seu software ou para qualificar o ambiente atualizado antes de implantá-lo para os usuários finais.
Os procedimentos a seguir descrevem como gerenciar as versões do agente de WorkSpaces aplicativos.
**Topics**
+ [Crie uma imagem que sempre use a versão mais recente do WorkSpaces Applications Agent](create-image-that-always-uses-latest-agent.md)
+ [Crie uma imagem que use uma versão específica do WorkSpaces Applications Agent](create-image-that-uses-specific-agent.md)
+ [Crie uma imagem que use uma versão mais recente do WorkSpaces Applications Agent](create-image-that-uses-newer-agent.md)
# Crie uma imagem que sempre use a versão mais recente do WorkSpaces Applications Agent
Quando suas imagens são configuradas para sempre usar a versão mais recente do agente de WorkSpaces aplicativos, suas instâncias de streaming são atualizadas automaticamente com os recursos mais recentes, melhorias de desempenho e atualizações de segurança que estão disponíveis a partir do AWS lançamento de uma nova versão do agente.
**nota**
Em alguns casos, uma nova versão do agente de WorkSpaces aplicativos pode entrar em conflito com seu software. Recomendamos que você qualifique a nova versão do agente de WorkSpaces aplicativos antes de implantá-la em suas frotas de produção.
**Para criar uma imagem que sempre use a versão mais recente do agente de WorkSpaces aplicativos**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Realize um dos procedimentos a seguir:
+ Se você tiver um criador de imagens que deseja usar para criar a imagem, inicie o criador de imagens e conecte-se a ele. Se o construtor de imagens não estiver executando a versão mais recente do agente de WorkSpaces aplicativos, você será solicitado a escolher se deseja iniciar o criador de imagens com o agente mais recente. Certifique-se de que essa opção está selecionada, escolha **Start (Iniciar)** e, em seguida, conecte-se ao criador de imagens.
+ Se você não tiver um criador de imagem que deseja usar para criar a imagem, inicie um novo criador de imagem. Na **Etapa 1: Escolher imagem**, escolha uma imagem AWS base ou uma imagem personalizada. Na **Etapa 2: Configurar o Image Builder**, se a imagem escolhida não estiver executando a versão mais recente do agente WorkSpaces Applications, a seção **WorkSpaces Applications** será exibida. Na lista **Agent version (Versão do agente)**, selecione a versão mais recente. Conclua as etapas restantes para gerar o criador de imagens e, em seguida, se conecte a ele. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).
1. Na área de trabalho do criador de imagens, abra o assistente de imagens e siga as etapas para criar a nova imagem. Na etapa **Configure Image (Configurar imagem)**, garanta que **Always use the latest agent version (Sempre usar a versão de agente mais recente)** esteja selecionado. Para obter mais informações, consulte [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md).
Se, posteriormente, você decidir não usar sempre a versão mais recente do agente de WorkSpaces aplicativos, deverá criar uma nova imagem e desmarcar essa opção.
1. Crie uma nova frota ou modifique uma existente. Ao configurar a frota, selecione a nova imagem que você criou. Para obter mais informações, consulte [Crie uma frota e uma pilha de WorkSpaces aplicativos da Amazon](set-up-stacks-fleets.md).
1. Crie uma nova pilha ou modifique uma existente e associe-a com sua frota.
# Crie uma imagem que use uma versão específica do WorkSpaces Applications Agent
Talvez você queira controlar as atualizações do agente WorkSpaces Applications em vez de sempre usar a versão mais recente para poder testar primeiro a compatibilidade. Para garantir que a versão do agente de WorkSpaces aplicativos que você usa seja compatível com seus aplicativos de streaming, você pode criar uma imagem que use uma versão específica do software do agente. Em seguida, execute os testes de qualificação em uma frota separada de produção antes de implantá-la à sua frota.
Ao criar a imagem, certifique-se de que a opção **Always use latest agent version (Sempre usar a versão de agente mais recente)** não está selecionada. Isso fixa sua imagem à versão do agente de WorkSpaces aplicativos que você selecionou ao iniciar o criador de imagens, em vez de sempre usar a versão mais recente. Depois de concluir os testes de qualificação de produção, você pode atualizar sua frota com a imagem.
**Para criar uma imagem que usa uma versão específica do agente de WorkSpaces aplicativos**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Realize um dos procedimentos a seguir:
+ Se você tiver um criador de imagens que deseja usar para criar a imagem, inicie o criador de imagens e conecte-se a ele.
+ Se você não tiver um criador de imagem que deseja usar para criar a imagem, inicie um novo criador de imagem. Na **Etapa 1: Escolher imagem**, escolha uma imagem AWS base ou uma imagem personalizada. Na **Etapa 2: Configurar o Image Builder**, se a imagem escolhida não estiver executando a versão mais recente do agente WorkSpaces Applications, a seção **WorkSpaces Applications** será exibida. Na lista **Agent version (Versão do agente)**, não selecione a versão mais recente. Conclua as etapas restantes para gerar o criador de imagens e, em seguida, se conecte a ele. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).
1. Na área de trabalho do criador de imagens, abra o assistente de imagens e siga as etapas para criar a nova imagem. Na etapa **Configure Image (Configurar imagem)** no assistente de imagem, garanta que **Always use the latest agent version (Sempre usar a versão de agente mais recente)** não esteja selecionado. Para obter mais informações, consulte [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md).
Se, posteriormente, você decidir sempre usar a versão mais recente do agente de WorkSpaces aplicativos, deverá criar uma nova imagem e selecionar essa opção.
1. Crie uma nova frota ou modifique uma existente. Ao configurar a frota, selecione a nova imagem que você criou. Para obter mais informações, consulte [Crie uma frota e uma pilha de WorkSpaces aplicativos da Amazon](set-up-stacks-fleets.md).
1. Crie uma nova pilha ou modifique uma existente e associe-a com sua frota.
1. Conecte-se à sua frota e teste seus aplicativos de compatibilidade.
# Crie uma imagem que use uma versão mais recente do WorkSpaces Applications Agent
Se você fixar sua imagem em uma versão específica do WorkSpaces Applications Agent, deverá atualizar para uma versão mais recente criando uma nova imagem. Essa abordagem permite que você teste cada atualização de agente para verificar primeiro a compatibilidade e, em seguida, atualize sua frota de forma incremental.
Ao criar a imagem, certifique-se de que a opção **Always use latest agent version (Sempre usar a versão de agente mais recente)** não está selecionada. Depois de criar sua imagem, execute os testes de qualificação em uma frota separada de produção antes de implantá-la à sua frota. Depois de concluir os testes de qualificação de produção, você pode atualizar sua frota com a imagem.
**Para criar uma imagem que usa uma versão mais recente do agente de WorkSpaces aplicativos**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Realize um dos procedimentos a seguir:
+ Se você tiver um criador de imagens que deseja usar para criar a imagem, inicie o criador de imagens e conecte-se a ele. Se o construtor de imagens não estiver executando a versão mais recente do agente de WorkSpaces aplicativos, você será solicitado a escolher se deseja iniciar o criador de imagens com o agente mais recente. Certifique-se de que essa opção está selecionada, escolha **Start (Iniciar)** e, em seguida, conecte-se ao criador de imagens.
+ Se você não tiver um criador de imagem que deseja usar para criar a imagem, inicie um novo criador de imagem. Na **Etapa 1: Escolher imagem**, escolha uma imagem AWS base ou uma imagem personalizada. Na **Etapa 2: Configurar o Image Builder**, se a imagem escolhida não estiver executando a versão mais recente do agente WorkSpaces Applications, a seção **WorkSpaces Applications** será exibida. Na lista **Agent version (Versão do agente)**, selecione a versão mais recente. Conclua as etapas restantes para gerar o criador de imagens e, em seguida, se conecte a ele. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).
1. Na área de trabalho do criador de imagens, abra o assistente de imagens e siga as etapas para criar a nova imagem. Na etapa **Configure Image (Configurar imagem)** no assistente de imagem, garanta que **Always use the latest agent version (Sempre usar a versão de agente mais recente)** não esteja selecionado. Para obter mais informações, consulte [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md).
Se, posteriormente, você decidir sempre usar a versão mais recente do agente de WorkSpaces aplicativos, deverá criar uma nova imagem e selecionar essa opção.
1. Crie uma nova frota ou modifique uma existente. Ao configurar a frota, selecione a nova imagem que você criou. Para obter mais informações, consulte [Crie uma frota e uma pilha de WorkSpaces aplicativos da Amazon](set-up-stacks-fleets.md).
1. Crie uma nova pilha ou modifique uma existente e associe-a com sua frota.
1. Conecte-se à sua frota e teste seus aplicativos de compatibilidade.
# WorkSpaces Notas de versão do Agente de Aplicativos
O software agente da Amazon WorkSpaces Applications é executado em suas instâncias de streaming, permitindo que os usuários finais se conectem e iniciem seus aplicativos de streaming. A partir de 7 de dezembro de 2017, suas instâncias de streaming podem ser atualizadas automaticamente com os recursos mais recentes, melhorias de desempenho e atualizações de segurança disponíveis em AWS. Antes dessa data, as atualizações do agente eram incluídas nas novas versões de imagens base.
Para usar o software mais recente do WorkSpaces Applications Agent, você precisa reconstruir suas imagens usando novas imagens base publicadas até AWS 7 de dezembro de 2017 ou após. Ao fazer isso, a opção para habilitar atualizações automáticas do agente é selecionada por padrão no Image Assistant. Recomendamos que você deixe essa opção selecionada para que todas as novas instâncias de frota ou os criadores de imagens que são iniciados da imagem sempre usem a versão mais recente do agente. Para obter mais informações, consulte [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md).
A tabela a seguir descreve as atualizações mais recentes que estão disponíveis nas versões lançadas do agente de WorkSpaces aplicativos para instâncias do Windows.
| Versão do agente do Amazon WorkSpaces Applications | Alterações |
| --- | --- |
| 02-09-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-04-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-02-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 30/09/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 15/07/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 29/05/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-07-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 31-10-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-10-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 18/09/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 21/05/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 15/04/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/01/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-07-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-06-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 30/05/2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-08-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 13/04/2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 21/03/2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-10-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 20/06/2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 14/03/2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 21/02/2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 20-12-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-10-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-02-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-01-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 25/06/2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/05/2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 17-12-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 17-12-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 30/07/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-27-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 20/04/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-02-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-13-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 11-13-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-10-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 23/09/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 03/09/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 08/08/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 26/07/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/jun/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 07/maio/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2019/02/04 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2019/07/03 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2019/22/01 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2019/08/01 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/19/12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/17/12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/04/12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/14/11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/30/10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/24/10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-01-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/29/08 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 2018/26/07 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/06/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 06/06/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 31/05/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 21/05/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/03/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-24-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
| 07/12/2017 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/agent-software-versions.html) |
# Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos
Este tutorial descreve como criar imagens de WorkSpaces aplicativos baseadas nos sistemas operacionais Microsoft Windows Server. Para criar imagens personalizadas com base nos sistemas operacionais Amazon Linux 2, Rocky Linux ou Red Hat Enterprise Linux, consulte [Tutorial: Criar uma imagem personalizada de aplicativos baseados em Linux WorkSpaces](tutorial-create-linux-image.md).
Neste tutorial, você aprenderá a criar uma imagem personalizada do Amazon WorkSpaces Applications que contém aplicativos que você pode transmitir para seus usuários e as configurações padrão do aplicativo e do Windows para permitir que seus usuários comecem a usar seus aplicativos rapidamente. Para concluir este tutorial, você já deve ter um criador de imagem. Se você não tiver um criador de imagem, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).
**Importante**
Este tutorial contém informações que se aplicam à versão mais recente da imagem de base. Para obter mais informações, consulte [WorkSpaces Notas de versão do Applications Base Image e Managed Image Update](base-image-version-history.md).
**Topics**
+ [Etapa 1: Instalar aplicativos no criador de imagens](#tutorial-image-builder-install)
+ [Etapa 2: Criar um catálogo de WorkSpaces aplicativos](#tutorial-image-builder-add)
+ [Etapa 3: Criar configurações padrão de aplicativo e Windows](#tutorial-image-builder-create-default-app-settings)
+ [Etapa 4: Testar aplicativos](#tutorial-image-builder-test-applications)
+ [Etapa 5: otimizar aplicativos](#tutorial-image-builder-optimize)
+ [Etapa 6: Terminar a criação da imagem](#tutorial-image-builder-finish-create-image)
+ [Etapa 7 (opcional): marcar e copiar uma imagem](#tutorial-image-builder-tag-copy)
+ [Etapa 8: limpar](#tutorial-image-builder-finish)
## Etapa 1: Instalar aplicativos no criador de imagens
Nesta etapa, você conecta um criador de imagem e instala seus aplicativos no criador de imagem.
**Importante**
Para concluir essa etapa, é necessário fazer login no construtor de imagens com a conta de **Administrador** local ou uma conta de domínio com permissões de administrador local. Não renomeie nem exclua a conta de **Administrador** integrada local. Se você renomear ou excluir essa conta, o construtor de imagens não será iniciado e a criação da imagem falhará.
**Para instalar aplicativos no criador de imagens**
1. Conecte-se ao construtor de imagens executando uma das seguintes ações:
+ [Use o console de WorkSpaces aplicativos](managing-image-builders-connect-console.md) (somente para conexões com a web)
+ [Crie um URL de streaming](managing-image-builders-connect-streaming-URL.md) (para conexões de clientes da Web ou de WorkSpaces aplicativos)
**nota**
Se o criador de imagens ao qual você deseja se conectar estiver associado a um domínio do Active Directory e sua organização exigir login com cartão inteligente, você deverá criar uma URL de streaming e usar o cliente WorkSpaces Applications para a conexão. Para obter informações sobre o login com cartão inteligente, consulte [Cartões inteligentes](feature-support-USB-devices-qualified.md#feature-support-USB-devices-qualified-smart-cards).
1. Instale aplicativos a partir de um site de aplicativo ou outra origem de download. Instale os aplicativos desejados antes de prosseguir até a próxima etapa.
**nota**
Baixe e instale aplicativos somente de sites em que você confia.
Se um aplicativo precisar reiniciar o sistema operacional Windows, deixe que ele o faça. Antes do sistema operacional ser reiniciado, você será desconectado do construtor de imagens. Quando a reinicialização estiver concluída, conecte-se ao criador de imagens novamente e, em seguida, termine a instalação do aplicativo.
## Etapa 2: Criar um catálogo de WorkSpaces aplicativos
Nesta etapa, crie um catálogo de WorkSpaces aplicativos especificando aplicativos (*.exe), scripts em lote (.bat**) e atalhos de aplicativos (*.lnk**) para 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. Se escolher um atalho de aplicativo, esses valores são pré-preenchidos para você.
**Importante**
Para concluir essa etapa, é necessário se conectar em um construtor de imagens com a conta de **Administrador** local ou uma conta de domínio com permissões de administrador local.
**Para criar um catálogo de WorkSpaces aplicativos**
1. Na área de trabalho do criador de imagens, abra o Image Assistant (Assistente de imagem). O Image Assistant orienta você durante o processo de criação da imagem.
![\[Row of icons representing different functions in Image Assistant interface.\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/images/Image-Builder-Desktop-Image-Assistant.png)
1. Em **1. Adicionar aplicações**, selecione **\$1 Adicionar aplicação** e navegue até o local da aplicação, script ou atalho que deseja adicionar. Escolha **Open (Abrir)**.
1. Na caixa de diálogo **App Launch Settings (Configurações de execução do aplicativo)**, mantenha ou altere as configurações padrão para **Name (Nome)**, **Display Name (Nome de exibição)** e **Icon Path (Caminho de ícone)**. Opcionalmente, você pode especificar os parâmetros de inicialização (argumentos adicionais enviados ao aplicativo quando ele é inicializado) e um diretório de trabalho para o aplicativo. Quando terminar, selecione **Salvar**.
As configurações **Display Name (Nome de exibição)** e **Icon Path (Caminho de ícone)** determinam como o nome e o ícone do aplicativo aparecem no catálogo de aplicativos. O catálogo é exibido para os usuários quando eles entram em uma sessão de streaming de WorkSpaces aplicativos.
1. Repita as etapas 2 e 3 para cada aplicativo no Image Assistant e confirme que os aplicativos aparecem na guia **Add Apps (Adicionar aplicativos)**. Quando terminar, selecione **Next (Próximo)** para continuar usando o Image Assistant para criar sua imagem.
## Etapa 3: Criar configurações padrão de aplicativo e Windows
Nesta etapa, você cria configurações padrão do aplicativo e do Windows para seus usuários de WorkSpaces aplicativos. Isso permite que seus usuários comecem a usar os aplicativos rapidamente durante as sessões de streaming de WorkSpaces aplicativos, sem a necessidade de criar ou definir essas configurações sozinhos.
**Importante**
Para concluir essa etapa, é necessário estar conectado ao criador de imagens com a conta de **Template User (Usuário modelo)** local ou uma conta de usuário de domínio que não tem permissões de administrador local.
**Para criar configurações padrão de aplicativo e Windows para os usuários**
1. No Assistente de Imagens, em **2. Configure Apps**, selecione **Switch user**. Isso o desconecta da sessão atual e exibe o menu de login.
1. Realize um dos procedimentos a seguir:
+ Se o criador de imagens não estiver associado a um domínio do Active Directory, na guia **Local User (Usuário local)**, selecione **Template User (Usuário modelo)**. Essa conta permite que você crie as configurações padrão de aplicativo e Windows.
+ Se o criador de imagens estiver associado a um domínio do Active Directory, selecione **Directory User (Usuário de diretório)** e faça login como um usuário de domínio que não tem permissões de administrador local.
1. Na área de trabalho do criador de imagens, abra o Image Assistant, que exibe os aplicativos adicionados ao criar o catálogo de aplicativos.
1. Selecione o aplicativo para o qual deseja criar configurações padrão de aplicativo.
1. Depois que o aplicativo abrir, crie essas configurações, conforme necessário.
1. Quando terminar, feche o aplicativo e retorne ao Image Assistant.
1. Se você especificou mais que um aplicativo no Image Assistant, repita as etapas 4 a 6 para cada aplicativo, conforme necessário.
1. Se quiser configurações padrão do Windows, crie-as agora. Ao terminar, volte para o Image Assistant.
1. Selecione **Switch user (Alternar usuário)** e faça login com a mesma conta usada para criar o catálogo de aplicativos (uma conta com permissões de administrador local).
1. No Assistente de Imagens, em **2. Configure Apps**, execute uma das seguintes ações:
+ Se o criador de imagens não estiver associado a um domínio do Active Directory, selecione **Save settings (Salvar configurações)**.
+ Se o criador de imagens estiver associado a um domínio do Active Directory, na lista **Choose which user settings to copy (Selecionar quais configurações de usuário copiar)**, selecione a mesma conta usada para fazer login no criador de imagens ao criar as configurações padrão de aplicativo e Windows e, em seguida, selecione **Save settings (Salvar configurações)**.
A lista **Escolher quais configurações copiar** exibe todas as contas que têm configurações salvas no construtor de imagens.
1. Ao terminar, selecione **Next (Próximo)** para continuar a criação da sua imagem.
## Etapa 4: Testar aplicativos
Nesta etapa, verifique se os aplicativos adicionados abrem corretamente e são executados conforme o esperado. Para fazer isso, inicie uma nova sessão do Windows como um usuário que tem as mesmas permissões que os seus usuários.
**Importante**
Para concluir essa etapa, é necessário fazer login no construtor de imagens com a conta **Usuário de testes** local ou uma conta de domínio que não tem permissões de administrador local.
**Para testar seus aplicativos**
1. No Assistente de Imagens, em **3. Test**, execute uma das seguintes ações:
+ Se o criador de imagens não estiver associado a um domínio do Active Directory, selecione **Switch user (Alternar usuário)**.
+ Se o construtor de imagens estiver associado a um domínio do Active Directory, você precisar de uma conta de domínio para testar as aplicações e o usuário já tiver configurações no construtor de imagens, será necessário redefinir as configurações da aplicação para esse usuário. Para fazer isso, selecione o usuário na lista **User to reset (Usuário a ser redefinido)** e selecione **Reset (Redefinir)**. Ao terminar, selecione **Switch user (Alternar usuário)**.
**nota**
Se o criador de imagens for novo e nenhum usuário tem configurações no criador de imagens, a lista não exibe nenhum usuário.
1. Escolha o usuário que será utilizado para testar, executando uma das seguintes ações:
+ Se o criador de imagens não estiver associado a um domínio do Active Directory, selecione **Test User (Usuário de testes)**. Essa conta permite testar os aplicativos usando as mesmas políticas e permissões que os seus usuários.
+ Se o construtor de imagens estiver associado a um domínio do Active Directory, selecione **Usuário de diretório**, especifique as credenciais para uma conta de domínio que não tem permissões de administrador local no construtor de imagens e escolha **Iniciar sessão**.
1. Na área de trabalho do criador de imagens, abra o Image Assistant, que exibe os aplicativos especificados ao criar o catálogo de aplicativos.
1. Selecione o aplicativo que deseja testar, para confirmar que abre corretamente e que todas as configurações padrão de aplicativo criadas estão aplicadas.
1. Depois que o aplicativo abrir, teste-o conforme necessário. Quando terminar, feche o aplicativo e retorne ao Image Assistant.
1. Se você especificou mais que um aplicativo no Image Assistant, repita as etapas 4 e 5 para testar cada aplicativo, conforme necessário.
1. Ao terminar, selecione **Switch user (Alternar usuário)** e realize uma das seguintes ações:
+ Se o criador de imagens não estiver associado a um domínio do Active Directory, na guia **Local User (Usuário local)**, selecione **Administrator (Administrador)**.
+ Se o criador de imagens estiver associado a um domínio do Active Directory e você estiver conectado como um usuário de domínio com permissões de administrador local para especificar aplicativos no Image Assistant, faça login como esse usuário.
1. Selecione **Next (Próximo)** para continuar a criação da sua imagem.
## Etapa 5: otimizar aplicativos
Nesta etapa, o Image Assistant abre os aplicativos um após o outro, identifica suas dependências de inicialização e executa otimizações para garantir que os aplicativos sejam iniciados rapidamente. Essas são etapas obrigatórias realizadas em todos os aplicativos na lista.
**Para otimizar seus aplicativos**
1. No Assistente de Imagens, em **4. Optimize**, selecione **Launch**.
1. WorkSpaces Os aplicativos iniciam automaticamente o primeiro aplicativo da sua lista. Quando o aplicativo iniciar completamente, forneça as entradas necessárias para realizar a primeira experiência de execução do aplicativo. Por exemplo, um navegador web pode importar configurações antes mesmo de o aplicativo estar em pleno funcionamento.
1. Depois de concluir a primeira experiência de execução e verificar que o aplicativo é executado conforme o esperado, selecione **Continue (Continuar)**. Se adicionou mais de um aplicativo à imagem, cada aplicativo abre automaticamente. Repita essa etapa para cada aplicativo conforme necessário, mantendo todos os aplicativos em execução.
1. Ao terminar, a próxima guia no Assistente de Imagens, **5. Configure Image**, é exibida automaticamente.
## Etapa 6: Terminar a criação da imagem
Nesta etapa, selecione um nome de imagem e termine a criação da sua imagem.
**Para criar a imagem**
1. Digite um nome de imagem exclusivo e um nome de exibição da imagem opcional e a descrição. O nome da imagem não pode começar com “Amazon”AWS, "” ou "”AppStream.
Também é possível adicionar uma ou mais tags à imagem. Para fazer isso, escolha **Add Tag (Adicionar tag)** e digite uma chave e um 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). Quando concluir, selecione **Próximo**.
**nota**
Se você escolher uma imagem AWS base publicada em ou após 7 de dezembro de 2017, a opção **Sempre usar a versão mais recente do agente** será exibida, selecionada por padrão. Recomendamos que você deixe essa opção selecionada para que as instâncias de streaming que são executadas da imagem sempre usem a versão mais recente do agente. Se desabilitar essa opção, não será possível habilitá-la novamente após concluir a criação da imagem. Para obter informações sobre a versão mais recente do agente WorkSpaces Applications, consulte[WorkSpaces Notas de versão do Agente de Aplicativos](agent-software-versions.md).
1. Em **6. Revisar**, verifique os detalhes da imagem. Para fazer alterações, selecione **Previous (Anterior)** para navegar até a guia adequada do Image Assistant, faça as alterações e, em seguida, prossiga com as etapas no Image Assistant, conforme necessário.
1. Assim que terminar a revisão dos detalhes da imagem, selecione **Disconnect and Create Image (Desconectar e criar imagem)**.
1. A sessão remota desconecta em instantes. Quando a mensagem **Lost Connectivity (Conectividade perdida)** aparecer, feche a guia do navegador. Enquanto a imagem é criada, o status do criador de imagens aparece como **Snapshotting (Criação de snapshots)**. Não é possível se conectar ao criador de imagens até que esse processo seja concluído.
1. Retorne ao console e vá até **Images**, **Image Registry**. Verifique se a nova imagem é exibida na lista.
Enquanto a imagem estiver sendo criada, o status da imagem no registro de imagens do console aparece como **Pending (Pendente)** e não é possível se conectar a ela.
1. Selecione o ícone **Refresh (Atualizar)** periodicamente para atualizar o status. Assim que a imagem for criada, o status da imagem muda para **Available (Disponível)** e o criador de imagens é interrompido automaticamente.
Para continuar a criar imagens, inicie o criador de imagens e conecte-se a ele a partir do console ou crie um novo criador de imagens.
**nota**
Depois de criar a imagem, você será responsável por manter as atualizações do sistema operacional Windows. Para fazer isso, você pode usar atualizações de imagens de WorkSpaces aplicativos gerenciados. Você também é responsável por manter as atualizações das aplicações e suas dependências. Para obter mais informações, consulte [Mantenha a imagem de seus WorkSpaces aplicativos da Amazon Up-to-Date](keep-image-updated.md).
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.
## Etapa 7 (opcional): marcar e copiar uma imagem
Você pode adicionar uma ou mais tags a uma imagem durante a criação de imagens ou depois de criar uma imagem. Você também pode copiar a imagem na mesma região ou em uma nova região na mesma conta da Amazon Web Services. Copiar uma imagem de origem resulta em uma imagem de destino idêntica, mas distinta. AWS no entanto, não copia nenhuma tag definida pelo usuário. Além disso, você só pode copiar as imagens personalizadas criadas por você, não as imagens base fornecidas pela AWS.
**nota**
Você pode copiar até duas imagens em um destino ao mesmo tempo. Se o destino no qual você está copiando uma imagem já atingiu o limite de imagens, você receberá um erro. Para copiar a imagem, neste caso, você deve remover imagens do destino. Depois que o destino estiver abaixo da cota de imagem (também conhecida como limite), inicie a cópia da imagem na região de origem. Para obter mais informações, consulte [Quotas do Amazon WorkSpaces Applications Service](limits.md).
**Para adicionar tags a uma imagem existente**
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem à qual você deseja adicionar tags.
1. Selecione **Tags**, selecione **Add/Edit Tags**, selecione **Add Tag**, especifique a chave e o valor da tag e, em seguida, selecione **Save**.
Para obter mais informações, consulte [Marcando seus recursos de WorkSpaces aplicativos da Amazon](tagging-basic.md).
**Como copiar uma imagem**
Copiar uma imagem em regiões geográficas diferentes permite o streaming de aplicativos de várias regiões com base na mesma imagem. Ao transmitir seus aplicativos mais perto de seus usuários, você pode melhorar a experiência dos usuários em streaming de aplicativos com WorkSpaces aplicativos.
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.
1. Selecione **Actions** (Ações) e **Copy** (Copiar).
1. Na caixa de diálogo **Copy Image** (Copiar imagens), especifique as informações a seguir e, em seguida, selecione **Copy Image:** (Copiar imagem:).
+ Em **Destination region** (Região de destino), selecione a região na qual a nova imagem será copiada.
+ Em **Name** (Nome), especifique o nome que a imagem terá quando for copiada no destino.
+ Em **Description** (Descrição) (opcional), especifique a descrição que a imagem terá quando for copiada no destino.
1. Para verificar o andamento da operação de cópia, volte ao console e navegue até **Images** (Imagens) e **Image Registry** (Registro de imagens). Use a barra de navegação para mudar para a região de destino (se aplicável) e verifique se a nova imagem é exibida na lista de imagens.
A nova imagem é exibida inicialmente com o status **Copying** (Copiando) no registro de imagens do console. Quando a imagem é criada com êxito, o status muda para **Disponível**. Isso significa que você pode usá-la para iniciar uma pilha e fazer streaming de seus aplicativos.
## Etapa 8: limpar
Finalmente, interrompa seus construtores de imagens em execução para liberar recursos e evitar despesas não intencionais em sua conta. É recomendável interromper qualquer construtor de imagens em execução que não esteja sendo usado. Para obter mais informações, consulte [Preços de WorkSpaces aplicativos](https://aws.amazon.com/appstream2/pricing/).
**Para interromper o construtor de imagens em execução**
1. No painel de navegação, escolha **Images**, **Image Builders**, e selecione a instância do construtor de imagens em execução.
1. Escolha **Actions**, **Stop**.
# 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**.
# Crie sua imagem de WorkSpaces aplicativos da Amazon de forma programática usando as operações de CLI do Image Assistant
Você pode criar imagens do Amazon WorkSpaces Applications conectando-se a um construtor de imagens e usando as operações da interface gráfica do usuário (GUI) ou da interface de linha de comando (CLI) do Image Assistant. As operações da CLI do Image Assistant oferecem funcionalidade semelhante à GUI do Image Assistant. Com essas operações, você pode fazer o seguinte de forma programática:
+ Gerenciar os aplicativos que estão incluídos em uma imagem.
+ Salvar, atualizar e redefinir as configurações do aplicativo padrão.
+ Ative ou desative a estrutura dinâmica de WorkSpaces aplicativos.
+ Especificar tags.
+ Criar uma imagem.
Você pode usar essas operações para integrar a criação de imagens de WorkSpaces aplicativos ao seu processo contínuo de desenvolvimento de software de integração ou implantação.
Para trabalhar com as operações da CLI do Image Assistant, use o shell de linha de comando de sua escolha em um construtor de imagens. Por exemplo, você pode usar o prompt de comando do Windows ou PowerShell.
**nota**
O criador de imagens deve usar uma versão do agente de WorkSpaces aplicativos lançada em ou após 26 de julho de 2019. Se não tiver um construtor de imagens, você deverá criar um. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).
**Topics**
+ [Criação de configurações padrão de aplicativo e do Windows com as operações da CLI do Image Assistant](create-default-app-windows-settings-image-assistant.md)
+ [Como otimizar o desempenho de inicialização dos seus aplicativos com as operações da CLI do Image Assistant](optimize-app-launch-performance-image-assistant-cli.md)
+ [Visão geral do processo para criar programaticamente uma imagem de aplicativos da Amazon WorkSpaces](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Operações de CLI do Image Assistant para criar e gerenciar sua imagem de aplicativos Amazon WorkSpaces](cli-operations-managing-creating-image-image-assistant.md)
# Criação de configurações padrão de aplicativo e do Windows com as operações da CLI do Image Assistant
Você pode criar configurações padrão de aplicativo e do Windows para que os usuários possam começar a usar seus aplicativos rapidamente. Quando você cria essas configurações, os WorkSpaces Aplicativos substituem o perfil de usuário padrão do Windows pelo perfil que você configura. O perfil de usuário padrão do Windows é, então, usado para criar as configurações iniciais para os usuários na instância de frota. Se você criar essas configurações usando as operações da CLI do Image Assistant, seu instalador de aplicativos, ou a automação, deverá modificar o perfil de usuário padrão do Windows diretamente.
Para substituir o perfil de usuário padrão do Windows pelo de outro usuário do Windows, você também pode usar a operação `update-default-profile` da CLI do Image Assistant.
Para obter mais informações sobre como definir o aplicativo padrão e as configurações do Windows, consulte *Criando configurações padrão do aplicativo e do Windows para os usuários de seus WorkSpaces aplicativos* em[Configurações padrão do aplicativo e do Windows e desempenho de lançamento de aplicativos nos WorkSpaces aplicativos da Amazon](customizing-appstream-images.md).
# Como otimizar o desempenho de inicialização dos seus aplicativos com as operações da CLI do Image Assistant
WorkSpaces Os aplicativos permitem que você otimize o desempenho de lançamento de seus aplicativos para as sessões de streaming de seus usuários. Ao fazer isso usando as operações da CLI do Image Assistant, você pode especificar os arquivos a serem otimizados para a inicialização do aplicativo. A adição de arquivos ao manifesto de otimização do aplicativo reduz o tempo necessário para o aplicativo iniciar pela primeira vez em uma nova instância de frota. No entanto, isso também aumenta o tempo necessário para as instâncias de frota serem disponibilizadas aos usuários. O manifesto de otimização é um arquivo de texto delimitado por linha que é exclusivo de cada aplicativo.
**nota**
Se você integrar os manifestos de otimização de aplicativos usando as operações da CLI do Image Assistant e a GUI do Image Assistant, os manifestos serão mesclados.
Veja a seguir um exemplo de um arquivo de manifesto de otimização de aplicações:
```
C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml
```
Para obter mais informações sobre como otimizar o desempenho de inicialização dos seus aplicativos, consulte *Otimização do desempenho de inicialização dos seus aplicativos* em [Configurações padrão do aplicativo e do Windows e desempenho de lançamento de aplicativos nos WorkSpaces aplicativos da Amazon](customizing-appstream-images.md).
# Visão geral do processo para criar programaticamente uma imagem de aplicativos da Amazon WorkSpaces
Você pode usar as operações da CLI do Image Assistant com a automação de instalação do aplicativo para criar um fluxo de trabalho de criação de imagens de WorkSpaces aplicativos totalmente programático. Depois que a sua automação de instalação de aplicativos for concluída, mas antes que a imagem seja criada, use as operações da CLI do Image Assistant para especificar o seguinte:
+ Os arquivos executáveis que os usuários podem iniciar
+ Os manifestos de otimização para seus aplicativos
+ Metadados WorkSpaces de imagem de outros aplicativos
A visão geral de alto nível a seguir descreve o processo de criação programática de uma WorkSpaces imagem de aplicativos.
1. Use sua automação de instalação de aplicativos para instalar os aplicativos necessários em seu construtor de imagens. Essa instalação pode incluir os aplicativos que seus usuários iniciarão, quaisquer dependências e aplicativos em segundo plano.
1. Determine os arquivos e as pastas a serem otimizados.
1. Se aplicável, use a operação `add-application` CLI do Image Assistant para especificar os metadados do aplicativo e o manifesto de otimização para a imagem do WorkSpaces Applications.
1. Para especificar aplicativos adicionais para a imagem de WorkSpaces Aplicativos, repita as etapas de 1 a 3 para cada aplicativo, conforme necessário.
1. Se aplicável, use a operação `update-default-profile` da CLI do Image Assistant para substituir o perfil padrão do Windows e criar configurações padrão de aplicativo e do Windows para seus usuários.
1. Use a operação `create-image` da CLI do Image Assistant para criar a imagem.
# Operações de CLI do Image Assistant para criar e gerenciar sua imagem de aplicativos Amazon WorkSpaces
Esta seção descreve as operações da CLI do Image Assistant que você pode usar para criar e gerenciar a imagem do WorkSpaces Applications.
Nos criadores de imagens do Windows, o arquivo executável que inclui a interface da linha de comando está localizado em: C:\$1Program Files\$1 Amazon\$1 Photon\$1\$1 Image-Assistant.exe. ConsoleImageBuilder Para sua conveniência, esse arquivo executável está incluído na variável PATH do Windows. Isso permite que você chame as operações da CLI do Image Assistant sem especificar o caminho absoluto para o arquivo executável. Para chamar essas operações, digite o comando **image-assistant.exe**.
Nos construtores de imagens Linux, a ferramenta assistente de imagem está localizada em/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.
## Operação do `help`
Recupera uma lista de todas as operações da CLI do Image Assistant. Para cada operação na lista, é fornecida uma descrição e uma sintaxe de uso. Para exibir a ajuda para uma operação específica, digite o nome da operação e especifique o parâmetro **--help**. Por exemplo:
```
add-application --help
```
**Resumo**
```
help
```
**Saída**
Imprime na saída padrão a lista de operações disponíveis com uma descrição de suas funções.
## Operação do `add-application`
Adiciona o aplicativo à lista de WorkSpaces aplicativos para usuários de aplicativos. Os aplicativos nessa lista são incluídos no catálogo de aplicativos. O catálogo de aplicativos é exibido para os usuários quando eles entram em uma sessão de streaming de WorkSpaces aplicativos.
**nota**
Se você precisar fazer alterações na configuração de uma aplicação, remova a aplicação e adicione-a com as configurações atualizadas.
**Resumo**
```
add-application
--name
--absolute-app-path
[--display-name ]
[--absolute-icon-path ]
[--working-directory ]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path ]
```
**Opções**
**`--name` (string)**
Um nome exclusivo para o aplicativo. O tamanho máximo é de 256 caracteres. Você pode adicionar até 50 aplicativos. Você não pode usar caracteres de espaço em branco.
**`--absolute-app-path` (string)**
O caminho absoluto para o arquivo executável, o arquivo de lote ou script do aplicativo. O caminho deve apontar para um arquivo válido.
**`--display-name` (string)**
O nome para exibição do aplicativo no catálogo de aplicativos. Se você não especificar um nome de exibição, os WorkSpaces Aplicativos criarão um nome derivado do nome do arquivo executável. O nome é criado sem a extensão de arquivo e com sublinhados no lugar de espaços. O tamanho máximo é de 256 caracteres.
**`--absolute-icon-path` (string)**
O caminho absoluto para o ícone do aplicativo. O caminho deve apontar para um arquivo de ícone válido que é um dos seguintes tipos: .jpg, .png ou .bmp. As dimensões máximas são: 256 px x 256 px. Se você não especificar um caminho, o ícone padrão do arquivo executável será usado, se disponível. Se um ícone padrão não estiver disponível para o arquivo executável, um ícone padrão do aplicativo WorkSpaces Aplicativos será usado.
**`--working-directory` (string)**
O diretório de trabalho inicial do aplicativo quando o aplicativo é iniciado.
**`--absolute-manifest-path` (string)**
O caminho para um novo arquivo de texto delimitado por linha. O arquivo especifica os caminhos absolutos dos arquivos a serem otimizados antes de a instância de frota ser disponibilizada para streaming. O caminho deve apontar para um arquivo de texto válido.
**Saída de mensagem**
| Código de saída | Mensagem impressa na saída padrão | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | O aplicativo foi adicionado com êxito. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | São necessários privilégios de administrador para concluir a operação. |
| 1 | \$1"status": 1, "message": "Unable to add more than 50 apps to the catalog."\$1 | O aplicativo não pôde ser adicionado porque o número máximo de aplicativos que podem ser adicionados ao catálogo de WorkSpaces aplicativos de aplicativos é 50. |
| 1 | \$1"status": 1, "message": "Name is not unique"\$1 | Já existe um aplicativo com esse nome no catálogo de WorkSpaces aplicativos de aplicativos. |
| 1 | \$1"status”: 1, “mensagem”: “Arquivo não encontrado (absolute-app-path)"\$1 | O arquivo que foi especificado para absolute-app-path não foi encontrado. |
| 1 | \$1"status": 1, "message": "Unsupported file extension"\$1 | O parâmetro Absolute-app-path só é compatível com os seguintes tipos de arquivos: .exe e .bat. |
| 1 | \$1"status": 1, "message": "Directory not found (working-directory)" | O diretório que foi especificado working-directory não foi encontrado. |
| 1 | \$1"status": 1, "message": "Optimization-manifest not found: "\$1 | O arquivo que foi especificado para optimization-manifest não foi encontrado. |
| 1 | \$1"status": 1, "message": "File not found: "\$1 | Um arquivo que foi especificado no manifesto de otimização não foi encontrado. |
| 255 | \$1"status": 255, "message": \$1 | Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## Operação do `remove-application`
Remove um aplicativo da lista de WorkSpaces aplicativos da imagem Aplicativos. O aplicativo não é desinstalado nem modificado, mas os usuários não poderão iniciá-lo a partir do catálogo de WorkSpaces aplicativos de aplicativos.
**Resumo**
```
remove-application
--name
```
**Opções**
**`--name` (string)**
O identificador exclusivo do aplicativo a ser removido.
**Saída de mensagem**
| Código de saída | Mensagem impressa na saída padrão | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | O aplicativo foi removido com êxito. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | São necessários privilégios de administrador para concluir a operação. |
| 1 | \$1"status": 1, "message": "App not found"\$1 | O aplicativo especificado não pôde ser encontrado no catálogo de WorkSpaces aplicativos de aplicativos. |
| 255 | \$1"status": 255, "message": \$1 | Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## Operação do `list-applications`
Lista todos os aplicativos que são especificados no catálogo de aplicativos.
**Resumo**
```
list-applications
```
**Saída de mensagem**
| Código de saída | Mensagem impressa na saída padrão | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success", "applications": [ \$1..app1.. \$1, \$1 ..app2.. \$1]\$1 | Lista de aplicativos no catálogo de WorkSpaces aplicativos de aplicativos. |
| 255 | \$1"status": 255, "message": \$1 | Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## Operação do `update-default-profile`
Copia o perfil do usuário do Windows especificado para o perfil de usuário padrão do Windows. Os novos usuários que fizerem streaming herdarão as configurações armazenadas no perfil especificado.
**nota**
Essa operação não é compatível com a ferramenta de CLI do assistente de imagens do Linux.
**Resumo**
```
update-default-profile
[--profile ]
```
**Opções**
**`--profile` (string)**
O nome do usuário cujo perfil do Windows será copiado para o perfil de usuário padrão do Windows. Use o seguinte formato para o nome:
"\$1"
Se o seu construtor de imagens não estiver integrado a um domínio do Microsoft Active Directory, insira um ponto "." para o domínio. Se você não especificar um usuário, a conta de usuário do modelo de WorkSpaces aplicativos será usada.
**Saída de mensagem**
| Código de saída | Mensagem impressa na saída padrão | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | As configurações do usuário foram copiados para o perfil padrão do Windows. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | São necessários privilégios de administrador para concluir a operação. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | As configurações do usuário não foram copiadas porque um arquivo ou uma pasta estava indisponível. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Um usuário do domínio do Microsoft Active Directory foi especificado, mas o construtor de imagens não está associado a um domínio do Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## Operação do `reset-user-profile`
Exclui o perfil de usuário do Windows para o usuário especificado.
**nota**
Essa operação não é compatível com a ferramenta de CLI do assistente de imagens do Linux.
**Resumo**
```
reset-user-profile
[--profile ]
```
**Opções**
**`--profile` (string)**
O nome do usuário do Windows cujo perfil do Windows será excluído. Use o seguinte formato para o nome:
"\$1"
Se o seu construtor de imagens não estiver integrado a um domínio do Microsoft Active Directory, insira um ponto "." para o domínio.
**Saída de mensagem**
| Código de saída | Mensagem impressa na saída padrão | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | As configurações do usuário especificado foram excluídas com êxito. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | São necessários privilégios de administrador para concluir a operação. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | As configurações do usuário não puderam ser redefinidas porque um arquivo ou uma pasta estava indisponível. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Um usuário do domínio do Microsoft Active Directory foi especificado, mas o construtor de imagens não está associado a um domínio do Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## Operação do `create-image`
Inicia o fluxo de trabalho de criação de imagens, resultando em uma imagem de WorkSpaces aplicativos que pode ser usada para frotas de WorkSpaces aplicativos.
**Resumo**
```
create-image
--name
[--description ]
[--display-name ]
[--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog]
[--use-latest-agent-version] | [--no-use-latest-agent-version]
[--tags ]
[--dry-run]
```
**Opções**
**`--name` (string)**
O nome da imagem dos WorkSpaces aplicativos. O nome deve ser exclusivo na conta e na AWS região da Amazon Web Services. O tamanho máximo é 100 caracteres. Os caracteres permitidos são:
a–z, A–Z, 0–9, sublinhados (\$1), hifens (-) e pontos (.)
O nome da imagem não pode começar com nenhum um dos seguintes prefixos: “aws” “appstream” e “amazon”. Esses prefixos são reservados para uso da AWS .
**`--description` (string)**
A descrição a ser exibida para a imagem. O tamanho máximo é de 256 caracteres.
**`--display-name` (string)**
O nome a ser exibido para a imagem. O tamanho máximo é de 256 caracteres.
**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**
Ativa ou desativa o suporte para a estrutura de WorkSpaces aplicativos dinâmicos de aplicativos. Se você não especificar nenhum parâmetro, o suporte para a estrutura de aplicativos dinâmicos não será habilitado.
A estrutura dinâmica de aplicativos fornece operações em uma instância de streaming de WorkSpaces aplicativos que você pode usar para criar um provedor de aplicativos dinâmico. Os provedores de aplicativos dinâmicos podem usar essas operações para modificar o catálogo de aplicativos que os usuários podem acessar em tempo real. Para obter mais informações, consulte [Use o WorkSpaces Applications Dynamic Application Framework para criar um provedor de aplicativos dinâmico](build-dynamic-app-provider.md).
**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**
Especifica se a imagem deve ser fixada na versão do agente de WorkSpaces aplicativos atualmente instalada ou se deve sempre usar a versão mais recente do agente. Se você não especificar nenhum dos parâmetros, a imagem será fixada na versão do agente de WorkSpaces aplicativos que está atualmente instalada. Para obter mais informações, consulte [Gerenciar versões do WorkSpaces Applications Agent](base-images-agent.md).
**`--tags` (string)**
As tags a serem associadas à imagem. Uma tag é um par de chave-valor. Use o formato a seguir:
--tags "mykey" "myval" "mykey2" "myval2"
Para obter mais informações sobre tags, consulte [Marcando seus recursos de WorkSpaces aplicativos da Amazon](tagging-basic.md).
**`--dry-run` (string)**
Executa a validação sem criar a imagem. Use esse comando para identificar se sua imagem tem algum problema antes de criá-la.
**Saída de mensagem**
| Código de saída | Mensagem impressa na saída padrão | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | O fluxo de trabalho para criar a imagem foi iniciado com êxito. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | São necessários privilégios de administrador para concluir a operação. |
| 1 | \$1"status": 1, "message": "An image with the given name already exists"\$1 | Já existe uma imagem com o nome especificado na conta da Amazon Web Services. |
| 1 | \$1"status": 1, "message": "Invalid value (tags)"\$1 | As tags especificadas não são válidas. |
| 255 | \$1"status": 255, "message": \$1 | Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
# Criar imagens baseadas em Linux
Você pode criar imagens da WorkSpaces Amazon Applications baseadas em Linux conectando-se a um construtor de imagens Linux, instalando os aplicativos necessários, criando configurações de aplicativo e variáveis de ambiente padrão e usando uma ferramenta de interface de linha de comando (CLI) ou uma ferramenta de assistente de imagem (GUI) para adicionar esses aplicativos ao catálogo de aplicativos. Para abrir a ferramenta de GUI, procure por **Assistente de Imagens** na lista de aplicações.
**Topics**
+ [Criar configurações padrão de aplicação para os usuários](create-default-app-settings.md)
+ [Criar variáveis de ambiente padrão para os usuários do Linux](create-default-variables-linux.md)
+ [Otimizar a performance de inicialização das aplicações do Linux](optimize-launch-performance.md)
+ [Criar scripts de sessão](create-session-scripts.md)
+ [Usar a ferramenta de CLI do Assistente de Imagens para Linux](image-assistant-cli.md)
+ [Habilitar e desabilitar o suporte para webcam](webcam-support.md)
+ [Ativação e desativação do modo de sincronização pesada de arquivos para pastas base](heavy-file-sync.md)
+ [Tutorial: Criar uma imagem personalizada de aplicativos baseados em Linux WorkSpaces](tutorial-create-linux-image.md)
+ [Tutorial: Habilitar suporte ao idioma japonês para imagens do Linux](enable-japanese-support-linux.md)
# Criar configurações padrão de aplicação para os usuários
Siga estas etapas para criar configurações padrão de aplicações para seus usuários.
**Topics**
+ [Etapa 1: Instalar aplicações do Linux no construtor de imagens](#app-settings-image-install)
+ [Etapa 2: criar uma TemplateUser conta](#app-settings-template-user)
+ [Etapa 3: Criar configurações padrão de aplicação](#app-settings-image-create-default-app-settings)
+ [Etapa 4: Salvar as configurações padrão de aplicação](#app-settings-image-save-default-app-settings)
+ [Etapa 5: Testar as configurações padrão de aplicação (opcional)](#app-settings-image-test-applications)
+ [Etapa 6: Limpeza](#app-settings-image-finish)
## Etapa 1: Instalar aplicações do Linux no construtor de imagens
Nesta etapa, conecte um construtor de imagens e instale aplicações nele.
**Para instalar aplicativos no criador de imagens**
1. Conecte-se ao construtor de imagens executando uma das seguintes ações:
+ [Use o console de WorkSpaces aplicativos](managing-image-builders-connect-console.md) (somente para conexões com a web)
+ [Crie um URL de streaming](managing-image-builders-connect-streaming-URL.md) (para conexões de clientes da Web ou de WorkSpaces aplicativos)
**nota**
Você estará logado como ImageBuilderAdmin usuário no desktop Amazon Linux GNOME e terá privilégios de administrador root.
1. Instale as aplicações que precisar. Por exemplo, para instalar um navegador Chromium de um repositório yum público, abra a aplicação do Terminal e execute o seguinte comando:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
## Etapa 2: criar uma TemplateUser conta
Nesta etapa, você cria uma TemplateUser conta, que cria as configurações padrão do aplicativo para seus usuários de streaming.
**Para criar uma TemplateUser conta**
1. Crie uma TemplateUser conta que não tenha permissões de root. Por exemplo, em uma janela do Terminal, execute os seguintes comandos para criar TemplateUser no construtor de imagens:
**[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser**
**[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**
1. Mude para a TemplateUser conta:
**[ImageBuilderAdmin]\$1 su - TemplateUser**
## Etapa 3: Criar configurações padrão de aplicação
Nesta etapa, você cria as configurações padrão do aplicativo para os usuários de seus WorkSpaces aplicativos. Isso permite que seus usuários comecem a usar os aplicativos rapidamente durante as sessões de streaming de WorkSpaces aplicativos, sem a necessidade de criar ou definir essas configurações sozinhos.
**Como criar configurações padrão de aplicação para os usuários**
1. Inicie a aplicação para a qual você quer criar as configurações padrão. Por exemplo, em uma janela do Terminal, execute o seguinte comando para iniciar o navegador Chromium:
**[TemplateUser]\$1 chromium-browser**
1. Defina as configurações da aplicação. Por exemplo, defina a página inicial do navegador Chromium como **https://aws.amazon.com**.
1. Feche as aplicações.
1. Encerre a sessão:
**[TemplateUser]\$1 logout**
## Etapa 4: Salvar as configurações padrão de aplicação
Nesta etapa, copie as configurações padrão de aplicação adicionadas para o diretório **/etc/skel/** e disponibilize-as para os usuários de streaming.
**Como salvar as configurações padrão de aplicação**
+ Execute o seguinte comando em uma janela do Terminal para copiar as configurações padrão de aplicação para os usuários de streaming:
**[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**
## Etapa 5: Testar as configurações padrão de aplicação (opcional)
Nesta etapa, verifique se as aplicações que você adicionou são executadas corretamente e se as configurações padrão de aplicação funcionam conforme o esperado.
**Como testar aplicações e configurações padrão em um construtor de imagens**
1. Crie um usuário de teste que não tenha permissões de raiz. Por exemplo, em uma janela do **Terminal**, execute os seguintes comandos para criar **test-user** no construtor de imagens:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user**
1. Mude para o usuário de teste:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Inicialize a aplicação (por exemplo, Chromium) como o usuário de teste:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Verifique se as configurações padrão estão disponíveis para o usuário de teste (por exemplo, a página inicial do Chromium é https://aws.amazon.com/).
1. Encerre a sessão:
**[test-user]\$1 logout**
## Etapa 6: Limpeza
Por fim, a última etapa é realizar a limpeza.
**Para limpar**
1. Excluir TemplateUser:
**[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**
**[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**
1. Excluir test-user (não é necessário se você pulou a etapa 5):
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**ImageBuilderAdmin]\$1 sudo userdel -r test-user**
# Criar variáveis de ambiente padrão para os usuários do Linux
Você pode criar variáveis de ambiente em uma instância do construtor de imagens do Linux. As variáveis de ambiente criadas são disponibilizadas nas instâncias de streaming criadas com base na respectiva imagem.
**nota**
Em instâncias de frota Linux, as variáveis de ambiente definidas usando a ferramenta Image Assistant (GUI) e as variáveis de ambiente padrão do sistema são exportadas por meio do script/etc/profile.d/appstream\$1system\$1vars.sh script. To access these environment variables, you must explicitly source the /etc/profile.d/appstream\$1system\$1vars.sh em seus aplicativos.
**Como criar variáveis de ambiente para os usuários**
1. Se a pasta `/etc/profile` não existir, execute o seguinte comando para criá-la:
**[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d**
1. Para criar um arquivo de script de shell (por exemplo, my-environment.sh) nessa pasta, execute o seguinte comando:
**[ImageBuilderAdmin]\$1 vim my-environment.sh**
1. Na primeira linha do arquivo de script, adicione o seguinte conteúdo:
**\$1\$1/bin/sh **
1. Para cada linha subsequente, adicione um comando **export** para definir as variáveis de ambiente para a imagem. O exemplo a seguir adiciona `$HOME/bin` à variável `PATH`.
**export PATH=”\$1HOME/bin:\$1PATH”**
1. Pressione a tecla **Esc** para retornar ao modo de comando no vim, depois execute o seguinte comando para salvar o script e sair do vim:
**:x**
1. Execute o seguinte comando para permitir que o script seja executado como um programa:
**[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**
# Otimizar a performance de inicialização das aplicações do Linux
Se você utiliza a ferramenta de GUI do Assistente de Imagens, ela otimiza automaticamente a performance de inicialização das aplicações.
Se você estiver usando a CLI do Assistente de Imagens, use as etapas a seguir para otimizar a performance de inicialização manualmente. Quando você cria e adiciona arquivos a um manifesto de otimização de aplicações, a aplicação será inicializada mais rapidamente quando for iniciada pela primeira vez em uma nova instância de frota. No entanto, isso também aumenta o tempo necessário para as instâncias de frota serem disponibilizadas aos usuários. O manifesto de otimização é um arquivo de texto delimitado por uma linha para cada aplicação.
Você pode criar um arquivo de manifesto (como < *your-app* >-manifest.txt) manualmente ou seguindo as etapas abaixo.
**Para criar um arquivo de manifesto**
1. Garanta que a aplicação que você está tentando otimizar tenha sido inicializada e esteja em execução.
1. Em um terminal do construtor de imagens do Linux, execute o seguinte comando:
**ps -ef \$1 grep <*application-process-name*>**
1. Pesquise o menor número PID na saída da última etapa. Esse é o PID do processo pai raiz da aplicação.
1. Mantenha a aplicação em execução e use os componentes iniciais exigidos pelos usuários. Isso garante que esses componentes sejam capturados pelo processo de otimização.
1. Crie um arquivo de script (por exemplo, `~/getfilestool.sh`) com o seguinte conteúdo:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Garanta que o arquivo possa ser executado com o seguinte comando:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Execute o comando a seguir para capturar todos os arquivos em execução do processo pai raiz encontrado na etapa 3 e salve-os em um arquivo de manifesto temporário.
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/-manifest.txt **
1. Verifique o conteúdo do manifesto de otimização, que é um arquivo de texto delimitado por linhas para cada aplicação.
Você pode especificar o manifesto de otimização para cada aplicação usando as operações da ferramenta de interface de linha de comandos (CLI) do Assistente de Imagens. Para obter mais informações, consulte [Usar a ferramenta de CLI do Assistente de Imagens para Linux](image-assistant-cli.md).
# Criar scripts de sessão
WorkSpaces Os aplicativos fornecem scripts de sessão na instância em instâncias de streaming baseadas em Windows e Linux. Para obter mais informações sobre os scripts de sessão, consulte [Use scripts de sessão para gerenciar a experiência de streaming dos usuários de seus WorkSpaces aplicativos Amazon](use-session-scripts.md).
Os scripts de sessão são especificados em uma imagem de WorkSpaces aplicativos. Para localizar o arquivo de configuração dos scripts de sessão em uma instância do Linux, navegue até `/opt/appstream/SessionScripts/config.json`. O código a seguir é um exemplo de arquivo `config.json` que especifica um script de início de sessão chamado “`test-session-start`” e um script de fim de sessão chamado “`test-session-stop`” com os respectivos parâmetros de tempo de execução. que os scripts referenciados em `config.json` tenham permissões de execução e que um interpretador de comandos esteja definido (por exemplo, \$1\$1/bin/bash).
```
{
"SessionStart": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-start",
"Arguments": "arg1",
"S3LogEnabled": true
}
],
"WaitingTime": 30
},
"SessionTermination": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-stop",
"Arguments": "arg2",
"S3LogEnabled": true
}
],
"WaitingTime": 30
}
}
```
# Usar a ferramenta de CLI do Assistente de Imagens para Linux
Em um construtor de imagens baseado em Linux, você pode usar a ferramenta CLI do Image Assistant **AppStreamImageAssistant**para criar e gerenciar sua imagem de aplicativos. WorkSpaces A ferramenta está localizada em `/usr/local/appstream/image-assistant/AppStreamImageAssistant` com um link simbólico em `/bin/AppStreamImageAssistant`. Essa ferramenta de CLI para Linux oferece suporte a várias das mesmas operações da ferramenta de CLI do Assistente de Imagens para Windows. Para obter mais informações sobre essas operações, consulte [Operações de CLI do Image Assistant para criar e gerenciar sua imagem de aplicativos Amazon WorkSpaces](cli-operations-managing-creating-image-image-assistant.md).
# Habilitar e desabilitar o suporte para webcam
WorkSpaces Os aplicativos oferecem suporte a áudio e vídeo (AV) em tempo real redirecionando a entrada de vídeo local da webcam para WorkSpaces as sessões de streaming de aplicativos. Esse recurso permite que seus usuários usem a webcam local para videoconferência e áudio em uma sessão de streaming de WorkSpaces aplicativos. Com AV em tempo real e suporte para áudio em tempo real, seus usuários podem colaborar usando aplicativos familiares de videoconferência e audioconferência sem precisar sair da sessão de streaming de WorkSpaces aplicativos.
Para usar esse recurso, você deve usar uma imagem de WorkSpaces aplicativos Linux que usa um agente de WorkSpaces aplicativos Linux lançado em ou após 21 de setembro de 2022.
**nota**
O AV em tempo real não é compatível com as instâncias stream.standard.small baseadas no Rocky Linux ou Red Hat Enterprise Linux. Os usuários não veem os ícones da câmera e do microfone na barra de ferramentas do cliente.
O recurso de AV em tempo real é habilitado por padrão em sessões de streaming do Linux. Para configurar permissões de webcam para os usuários em um construtor de imagens do Linux, crie `/etc/appstream/appstream.conf` e adicione o seguinte conteúdo:
**nota**
Especifique **1** para habilitar a webcam ou **0** para desabilitá-la.
```
[webcam]
permission = 1
```
# Ativação e desativação do modo de sincronização pesada de arquivos para pastas base
Você pode habilitar as Amazon Simple Storage Service opções de Pastas Pessoais para sua organização. Quando você habilita as pastas iniciais do Amazon S3 para uma pilha de WorkSpaces aplicativos, os usuários da pilha podem acessar uma pasta de armazenamento persistente durante suas sessões de streaming de aplicativos. Não é necessária nenhuma configuração adicional para que os usuários acessem a pasta base. Os dados armazenados pelos usuários em sua pasta inicial são automaticamente copiados para um bucket do Amazon S3 em sua Conta da AWS pasta e disponibilizados para esses usuários em sessões subsequentes. Para obter mais informações, consulte [Habilite e administre pastas pessoais para os usuários de seus WorkSpaces aplicativos](home-folders.md).
Para garantir uma experiência tranquila e resolver algumas limitações existentes, nas quais uma sincronização de arquivos inconsistente pode ser observada quando os usuários salvam grandes arquivos de texto de suas instâncias de streaming em suas pastas pessoais, os administradores de WorkSpaces aplicativos podem ativar a opção de configuração **heavy\$1sync** se o upload de arquivos grandes para o Amazon S3 for um cenário comum do usuário ao usar aplicativos. WorkSpaces A ativação dessa opção significa que ela pode adicionar alguma latência ao processo de sincronização de arquivos da pasta pessoal, mas a integridade de todas as sincronizações com o Amazon S3 é garantida.
Esse recurso está disponível em todas as imagens do Red Hat Enterprise Linux e imagens de WorkSpaces aplicativos Linux que usam um agente de WorkSpaces aplicativos Linux lançado em ou após 12 de setembro de 2024.
O recurso de sincronização pesada é desativado por padrão para sessões de streaming do Red Hat Enterprise Linux e do Amazon Linux. Para configurar a permissão de sincronização pesada para seus usuários em um criador de imagens do Red Hat Enterprise Linux ou do Amazon Linux, crie `/etc/appstream/appstream.conf` e adicione o seguinte conteúdo:
**nota**
Especifique **1** para ativar a sincronização pesada ou **0** para desativar a sincronização pesada.
```
[storage]
heavy_sync = 1
```
# Tutorial: Criar uma imagem personalizada de aplicativos baseados em Linux WorkSpaces
Este tutorial descreve como criar uma imagem personalizada da WorkSpaces Amazon Applications baseada em Linux que contém aplicativos que você pode transmitir para seus usuários.
**Importante**
Não crie um usuário chamado “as2-streaming-user” em seu criador de imagens. Esse é um nome de usuário reservado para a Frota. Se você criar esse nome de usuário fora do fluxo de trabalho dos WorkSpaces Aplicativos, poderá ter problemas de streaming no Fleets.
**Topics**
+ [Etapa 1: Instalar aplicações do Linux no construtor de imagens](#tutorial-linux-image-install)
+ [Etapa 2: Gerar o arquivo de manifesto de otimização de aplicações](#tutorial-linux-image-manifest)
+ [Etapa 3: Criar um catálogo de WorkSpaces aplicativos](#tutorial-linux-image-catalog)
+ [Etapa 4: Criar configurações padrão de aplicação e variáveis de ambiente](#tutorial-linux-image-create-default-app-settings)
+ [Etapa 5: Testar aplicações e configurações](#tutorial-linux-image-test-applications)
+ [Etapa 6: Terminar a criação da imagem](#tutorial-linux-image-finish-create-image)
+ [Etapa 7 (opcional): marcar e copiar uma imagem](#tutorial-linux-image-tag-copy)
+ [Etapa 8: limpar](#tutorial-linux-image-finish)
## Etapa 1: Instalar aplicações do Linux no construtor de imagens
Nesta etapa, conecte um construtor de imagens e instale aplicações nele.
**Para instalar aplicativos no criador de imagens**
1. Conecte-se ao construtor de imagens executando uma das seguintes ações:
+ [Use o console de WorkSpaces aplicativos](managing-image-builders-connect-console.md) (somente para conexões com a web)
+ [Crie um URL de streaming](managing-image-builders-connect-streaming-URL.md) (para conexões de clientes da Web ou de WorkSpaces aplicativos)
**nota**
Você estará logado como ImageBuilderAdmin usuário no desktop Amazon Linux GNOME e terá privilégios de administrador root.
1. Instale as aplicações que precisar. Por exemplo, para instalar um navegador Chromium de um repositório yum público, abra a aplicação do Terminal e execute o seguinte comando:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
**nota**
Baixe e instale aplicativos somente de sites em que você confia.
## Etapa 2: Gerar o arquivo de manifesto de otimização de aplicações
Nesta etapa, gere um arquivo de manifesto para cada aplicação instalada na etapa 1.
**Como gerar um arquivo de manifesto para otimizar a performance de inicialização de uma aplicação**
1. Garanta que a aplicação (por exemplo, Chromium) que você está tentando otimizar tenha sido inicializada e esteja em execução.
1. Em uma janela do Terminal, execute o seguinte comando para listar os processos relacionados à aplicação:
**[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **
1. Encontre o PID pai raiz na saída do comando acima. Veja a seguir um exemplo de saída, em que o PID pai raiz é 16712:
**Example**
```
[ImageBuilderAdmin]$ ps -ef | grep chromium
ImageBu+ 16712 4128 0 Aug26 ? 00:00:44 /usr/lib64/chromium- browser/chromium-browser --enable-plugins --enable-extensions -- enable-user- scripts --enable-printing --enable-gpu-rasterization -- enable-sync --auto-ssl- client-auth
ImageBu+ 16726 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygote --no-zygote-sandbox ImageBu+ 16727 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium- browser --type=zygote
ImageBu+ 16731 16727 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygot
```
1. Mantenha a aplicação em execução e use os componentes iniciais exigidos pelos usuários. Isso garante que esses componentes sejam capturados pelo processo de otimização.
1. Crie um arquivo de script (por exemplo, `~/getfilestool.sh`) com o seguinte conteúdo:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Execute o seguinte comando para verificar se o arquivo pode ser executado:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Execute o seguinte comando para capturar todos os arquivos em execução do processo pai raiz encontrado na etapa 3 acima e salve-os em um arquivo de manifesto temporário:
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **
1. Verifique o conteúdo do manifesto de otimização, que é um arquivo de texto delimitado por linhas para cada aplicação.
## Etapa 3: Criar um catálogo de WorkSpaces aplicativos
Nesta etapa, você usa a ferramenta CLI `AppStreamImageAssistant` no construtor de imagens para criar um catálogo de WorkSpaces aplicativos especificando aplicativos para sua imagem. Para cada aplicação da qual pretende fazer streaming, você pode especificar o nome, o nome de exibição, o arquivo executável para inicializar e o ícone para exibição.
**Para criar um catálogo de WorkSpaces aplicativos**
1. Na área de trabalho do construtor de imagens, abra o **Terminal** pelo painel lateral ou abrindo a grade da aplicação.
1. Execute **AppStreamImageAssistant --help** para ver a lista de comandos disponíveis. Você usará esses comandos para adicionar aplicações e criar uma imagem.
1. Execute o comando a seguir para adicionar um aplicativo instalado (por exemplo, Chromium) à lista de WorkSpaces aplicativos para usuários de aplicativos:
```
AppStreamImageAssistant add-application \
--name Chromium \
--absolute-app-path /usr/lib64/chromium-browser/chromium-browser \
--display-name Chromium \
--absolute-icon-path /usr/share/icons/hicolor/256x256/apps/chromium-browser.png \
--absolute-manifest-path /tmp/chromium-manifest.txt
```
Como alternativa, você pode executar o seguinte comando:
```
AppStreamImageAssistant add-application \
--name="Chromium" \
--absolute-app-path="/usr/lib64/chromium-browser/chromium-browser" \
--display-name="Chromium" \
--absolute-icon-path="/usr/share/icons/hicolor/256x256/apps/chromium-browser.png" \
--absolute-manifest-path="/tmp/chromium-manifest.txt"
```
1. Para adicionar mais aplicações, repita a etapa 3 para cada aplicação adicional.
1. Para ver a lista de aplicações que foram adicionadas ao catálogo e seus metadados, como caminhos de ícones e parâmetros de inicialização, execute o seguinte comando:
**AppStreamImageAssistant list-applications**
1. Para remover aplicações do catálogo, execute o seguinte comando:
**AppStreamImageAssistant remove-application –-name *application\$1name***
## Etapa 4: Criar configurações padrão de aplicação e variáveis de ambiente
Nesta etapa, você cria configurações de aplicativo e variáveis de ambiente padrão para os usuários de seus WorkSpaces aplicativos. Isso permite que seus usuários comecem a usar os aplicativos rapidamente durante as sessões de streaming de WorkSpaces aplicativos, sem a necessidade de criar ou definir essas configurações sozinhos.
**Como criar configurações padrão de aplicação e variáveis de ambiente para os usuários**
1. Inicialize a aplicação para a qual você deseja criar as configurações padrão. Por exemplo, em uma janela do Terminal, execute o seguinte comando para iniciar o navegador Chromium:
**[ImageBuilderAdmin]\$1 chromium-browser**
1. Defina as configurações da aplicação. Por exemplo, defina a página inicial do navegador Chromium como **https://aws.amazon.com**.
1. Verifique se o aplicativo Chromium está fechado e execute os seguintes comandos para copiar a configuração do Chromium para **/etc/skel**:
**[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**
**[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config**
1. Defina as variáveis de ambiente e adicione-as ao arquivo de script. Por exemplo, execute os seguintes comandos:
**[ImageBuilderAdmin]\$1 echo "export *FOO*=*BAR*" \$1 sudo tee -a /etc/profile.d/myenvvars.sh**
**[ImageBuilderAdmin]\$1 sudo chmod \$1x /etc/profile.d/myenvvars.sh**
## Etapa 5: Testar aplicações e configurações
Nesta etapa, verifique se as aplicações que você adicionou são executadas corretamente e se as configurações padrão de aplicação e as variáveis de ambiente funcionam conforme o esperado.
**Como testar aplicações e configurações padrão em um construtor de imagens**
1. Crie um usuário de teste que não tenha permissões de raiz. Por exemplo, em uma janela do **Terminal**, execute os seguintes comandos para criar **test-user** no construtor de imagens:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e 'Pa55w0rdas2\$1\$1\$1\$1nPa55w0rdas2\$1\$1\$1\$1n' \$1 sudo passwd test-user**
1. Mude para o usuário de teste:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Inicialize a aplicação (por exemplo, Chromium) como o usuário de teste:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Verifique se as configurações padrão estão disponíveis para o usuário de teste (por exemplo, a página inicial do Chromium é https://aws.amazon.com/).
1. Verifique se as variáveis de ambiente estão disponíveis para o usuário de teste. Por exemplo, execute o comando a seguir:
**[test-user]\$1 echo \$1*FOO***
Esse comando deve exibir a saída ***BAR*** no terminal.
1. Execute os seguintes comandos para excluir o usuário de teste antes de criar uma imagem usando esse construtor de imagens:
**\$1 logout test user**
**[test-user]\$1 logout**
**\$1 kill test user's running processes**
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**\$1 delete user**
**[ImageBuilderAdmin]\$1 sudo userdel -r test-user**
## Etapa 6: Terminar a criação da imagem
Nesta etapa, selecione um nome de imagem e termine a criação da sua imagem.
**Para criar a imagem**
1. Em uma janela do **Terminal**, crie uma imagem do construtor de imagens executando **AppStreamImageAssistant create-image**. Essa imagem contém suas aplicações instaladas e registradas, além de todos os scripts de sessão e configurações padrão de aplicação que você definiu.
Para ver a lista de opções disponíveis, execute **AppStreamImageAssistant create-image --help**. Para obter mais informações, consulte a operação **create-image** em [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).
1. A sessão remota é desconectada após instantes. Quando a mensagem **Lost Connectivity (Conectividade perdida)** aparecer, feche a guia do navegador. Enquanto a imagem é criada, o status do criador de imagens aparece como **Snapshotting (Criação de snapshots)**. Não é possível se conectar ao criador de imagens até que esse processo seja concluído.
1. Retorne ao console e vá até **Images**, **Image Registry**. Verifique se a nova imagem é exibida na lista.
Enquanto a imagem estiver sendo criada, o status dela no registro de imagens do console aparece como **Pending** (Pendente). Não é possível se conectar a imagens com status **Pendente**.
1. Selecione o ícone **Atualizar** para atualizar o status. Assim que a imagem for criada, o status da imagem muda para **Available (Disponível)** e o criador de imagens é interrompido automaticamente.
Para continuar a criar imagens, inicie o criador de imagens e conecte-se a ele a partir do console ou crie um novo criador de imagens.
## Etapa 7 (opcional): marcar e copiar uma imagem
Você pode adicionar uma ou mais tags a uma imagem durante a criação de imagens ou depois de criar uma imagem. Você também pode copiar a imagem na mesma região ou em uma nova região na mesma conta da Amazon Web Services. Copiar uma imagem de origem resulta em uma imagem de destino idêntica, mas distinta. AWS no entanto, não copia nenhuma tag definida pelo usuário. Além disso, você só pode copiar as imagens personalizadas criadas por você, não as imagens base fornecidas pela AWS.
**nota**
Você pode copiar até duas imagens em um destino ao mesmo tempo. Se o destino no qual você está copiando uma imagem já atingiu o limite de imagens, você receberá um erro. Para copiar a imagem, neste caso, você deve remover imagens do destino. Depois que o destino estiver abaixo da cota de imagem (também conhecida como limite), inicie a cópia da imagem na região de origem. Para obter mais informações, consulte [Quotas do Amazon WorkSpaces Applications Service](limits.md).
**Para adicionar tags a uma imagem existente**
1. No painel de navegação, selecione **Images** (Imagens) e **Image Registry** (Registro de imagens).
1. Na lista de imagens, selecione a imagem à qual você deseja adicionar tags.
1. Selecione **Etiquetas**, escolha **Adicionar/editar etiquetas** e selecione **Adicionar etiqueta**. Especifique a chave e o valor da etiqueta e selecione **Salvar**.
Para obter mais informações, consulte [Marcando seus recursos de WorkSpaces aplicativos da Amazon](tagging-basic.md).
**Como copiar uma imagem**
Copiar uma imagem em regiões geográficas diferentes permite o streaming de aplicativos de várias regiões com base na mesma imagem. Ao transmitir seus aplicativos mais perto de seus usuários, você pode melhorar a experiência dos usuários em streaming de aplicativos com WorkSpaces aplicativos.
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.
1. Selecione **Actions** (Ações) e **Copy** (Copiar).
1. Na caixa de diálogo **Copy Image** (Copiar imagens), especifique as informações a seguir e, em seguida, selecione **Copy Image:** (Copiar imagem:).
+ Em **Destination region** (Região de destino), selecione a região na qual a nova imagem será copiada.
+ Em **Name** (Nome), especifique o nome que a imagem terá quando for copiada no destino.
+ Em **Description** (Descrição) (opcional), especifique a descrição que a imagem terá quando for copiada no destino.
1. Para verificar o andamento da operação de cópia, volte ao console e navegue até **Images** (Imagens) e **Image Registry** (Registro de imagens). Use a barra de navegação para mudar para a região de destino (se aplicável) e verifique se a nova imagem é exibida na lista de imagens.
A nova imagem é exibida inicialmente com o status **Copying** (Copiando) no registro de imagens do console. Quando a imagem é criada com êxito, o status muda para **Disponível**. Isso significa que você pode usá-la para iniciar uma pilha e fazer streaming de seus aplicativos.
## Etapa 8: limpar
Por fim, interrompa os construtores de imagens em execução para liberar recursos e evitar despesas não intencionais em sua conta. É recomendável interromper qualquer construtor de imagens em execução que não esteja sendo usado. Para obter mais informações, consulte [Preços de WorkSpaces aplicativos](https://aws.amazon.com/appstream2/pricing/).
**Para interromper o construtor de imagens em execução**
1. No painel de navegação, escolha **Images**, **Image Builders**, e selecione a instância do construtor de imagens em execução.
1. Escolha **Actions**, **Stop**.
# Tutorial: Habilitar suporte ao idioma japonês para imagens do Linux
Este tutorial descreve como habilitar o suporte ao idioma japonês para uma imagem do Linux. Isso permite que as aplicações na imagem exibam caracteres japoneses e que os usuários de streaming usem o método de entrada em japonês em sessões de streaming pela imagem.
**Topics**
+ [Etapa 1: Instalar uma fonte e um método de entrada em japonês](#tutorial-japanese-font)
+ [Etapa 2: Definir o fuso horário do sistema](#tutorial-japanese-zone)
+ [Etapa 3: Definir o local do sistema e o idioma de exibição](#tutorial-japanese-locale)
+ [Etapa 4: Configurar métodos de entrada](#tutorial-japanese-input)
+ [Etapa 5: Definir o layout do teclado](#tutorial-japense-keyboard)
+ [Etapa 6: Verificar no construtor de imagens](#tutorial-japense-verify)
+ [Etapa 7: Criar a imagem](#tutorial-japanese-create)
## Etapa 1: Instalar uma fonte e um método de entrada em japonês
Nesta etapa, conecte um construtor de imagens do Linux e instale os pacotes de fonte e método de entrada de sua escolha.
**Como instalar uma fonte e um método de entrada em japonês**
1. Conecte-se ao construtor de imagens executando uma das seguintes ações:
+ [Use o console de WorkSpaces aplicativos](managing-image-builders-connect-console.md) (somente para conexões com a web)
+ [Crie um URL de streaming](managing-image-builders-connect-streaming-URL.md) (para conexões de clientes da Web ou de WorkSpaces aplicativos)
**nota**
Você estará logado como ImageBuilderAdmin usuário no desktop Amazon Linux GNOME e terá privilégios de administrador root.
1. Instale a fonte e o método de entrada necessários. Para isso, abra a aplicação do Terminal e execute os seguintes comandos:
**sudo yum install vlgothic-p-fonts.noarch**
**sudo yum install ibus-kkc.x86\$164**
1. Além dos comandos acima, para o Rocky Linux e Red Hat Enterprise Linux, execute o seguinte comando:
**sudo yum install glibc-langpack-ja**
## Etapa 2: Definir o fuso horário do sistema
Para definir o fuso horário do sistema, execute o seguinte comando:
**sudo timedatectl set-timezone "Asia/Tokyo"**
## Etapa 3: Definir o local do sistema e o idioma de exibição
Para definir o local do sistema e o idioma de exibição, execute os comandos a seguir.
**Como definir o local do sistema e o idioma de exibição**
1. Atualize o arquivo `cloud-init config` executando o comando **sudo vim /etc/cloud/cloud.cfg** e altere a **localidade** para **localidade: ja\$1JP.utf8**, depois salve e feche o arquivo.
1. Atualize as configurações do sistema executando **sudo localectl set-locale LANG=ja\$1JP.utf8**.
1. Atualize as configurações de shell do Gnome executando **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**.
## Etapa 4: Configurar métodos de entrada
Configure os métodos de entrada para a aplicação que você deseja adicionar à imagem. Para obter mais informações sobre como instalar uma aplicação, gerar um arquivo de manifesto e criar configurações padrão, consulte [Tutorial: Criar uma imagem personalizada de aplicativos baseados em Linux WorkSpaces](tutorial-create-linux-image.md). Nesta etapa, presumimos que você já tenha instalado a aplicação do Firefox, localizada em `/usr/local/firefox/firefox`.
**Como configurar métodos de entrada**
1. Crie um script executando o comando **sudo vim /usr/local/bin/update-input-method.sh** e adicione o seguinte conteúdo ao script:
```
#!/bin/bash
function start_process()
{
command=$1
process_name=$2
process_count=$(pgrep $process_name -c)
echo "$(date) current $process_name count: $process_count"
while [ $process_count -lt 1 ]
do
echo "$(date) starting $process_name"
eval $command
sleep 1
process_count=$(pgrep $process_name -c)
done
echo "$(date) $process_name started"
}
start_process "ibus-daemon --xim &" "ibus-daemon"
start_process "/usr/libexec/ibus-engine-kkc --ibus &" "ibus-engine-kkc"
gsettings set org.gnome.desktop.input-sources sources "[('ibus','kkc'), ('xkb', 'us')]"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source "['space']"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward "['space']"
echo "$(date) updated input source and switch shortcut"
```
No script acima, a primeira fonte de entrada ('ibus','kkc') é o método de entrada padrão. Você pode alterar o método de entrada padrão alterando a ordem das fontes de entrada. Além disso, “Control\$1Espaço” e “Shift\$1Control\$1Espaço” são especificados como combinações de teclas de atalho para alternar entre métodos de entrada. Você pode especificar suas próprias combinações de teclas que os usuários poderão usar para alternar os métodos de entrada durante as sessões de streaming.
1. Crie o script para inicializar a aplicação (Firefox) que você adicionará à imagem. Para fazer isso, execute o comando **sudo vim /usr/local/bin/firefox-jp.sh** e adicione o seguinte conteúdo ao script:
```
#!/bin/bash
# Gather required environment variables from the GNOME shell session
while IFS= read -r -d $'\0' env_var; do
case "$env_var" in
DBUS_SESSION_BUS_ADDRESS=*|\
GTK_IM_MODULE=*|\
QT_IM_MODULE=*|\
XMODIFIERS=*|\
XAUTHORITY=*)
echo "$env_var"
export "$env_var"
;;
esac
done < "/proc/$(pgrep -u as2-streaming-user gnome-shell | head -n1)/environ"
/usr/local/bin/update-input-method.sh > /var/tmp/update-input-method.log 2>&1 &
/usr/local/firefox/firefox &
```
1. Adicione permissão de execução aos dois scripts executando os seguintes comandos:
**sudo chmod \$1x /usr/local/bin/update-input-method.sh**
**sudo chmod \$1x /usr/local/bin/firefox-jp.sh**
1. Se você já criou o arquivo de manifesto de otimização para a aplicação, execute os seguintes comandos para adicionar o script de inicialização da aplicação ao catálogo de aplicações:
```
sudo AppStreamImageAssistant add-application \
--name firefox \
--absolute-app-path /usr/local/bin/firefox-jp.sh \
--display-name firefox \
--absolute-icon-path /usr/local/firefox/browser/chrome/icons/default/default128.png \
--absolute-manifest-path /tmp/firefox-manifest.txt
```
Como alternativa, você também pode configurar os métodos de entrada adicionando o script update-input-method .sh como um aplicativo separado ao catálogo de aplicativos da imagem. Durante as sessões de streaming, os usuários poderão iniciar essa aplicação para habilitar a entrada em japonês e alternar entre os métodos de entrada com teclas de atalho especificadas na mesma sessão.
## Etapa 5: Definir o layout do teclado
Defina o layout do teclado de acordo com os teclados que os usuários usarão durante as sessões de streaming. Você pode usar o comando **localectl list-keymaps** para listar todos os mapeamentos de teclas disponíveis e usar o comando **sudo localectl set-keymap jp106** para definir o mapeamento de teclas para o teclado japonês de 106 teclas, por exemplo.
## Etapa 6: Verificar no construtor de imagens
Para verificar no construtor de imagens, reinicialize o construtor de imagens executando o comando **sudo shutdown -r now**. Após a reinicialização, conecte-se novamente ao construtor de imagens e verifique se tudo, incluindo fuso horário, local, idioma e método de entrada, funciona conforme o esperado.
## Etapa 7: Criar a imagem
Crie a imagem no construtor de imagens. Para obter mais informações, consulte [Tutorial: Criar uma imagem personalizada de aplicativos baseados em Linux WorkSpaces](tutorial-create-linux-image.md). Crie configurações padrão de aplicação, incluindo as configurações regionais que você acabou de definir. Para obter mais informações, consulte “Creating Default Application Settings for Your Users” em [Criar imagens baseadas em Linux](create-linux-based-images.md).
Todas as instâncias de frota do Linux criadas com base nessa imagem terão as mesmas configurações padrão de fuso horário, local, idioma e método de entrada que você definiu para a imagem.
# Use scripts de sessão para gerenciar a experiência de streaming dos usuários de seus WorkSpaces aplicativos Amazon
WorkSpaces Os aplicativos fornecem scripts de sessão na instância. Você pode usar esses scripts para executar seus próprios scripts personalizados quando eventos específicos ocorrerem em sessões de streaming dos usuários. Por exemplo, você pode usar scripts personalizados para preparar seu ambiente de WorkSpaces aplicativos antes do início das sessões de streaming dos usuários. Você também pode usar scripts personalizados para limpar instâncias de streaming depois que os usuários concluem as sessões de streaming.
Os scripts de sessão são especificados em uma imagem de WorkSpaces aplicativos. Esses scripts são executados no contexto do usuário ou do sistema. Se os scripts de sessão usarem a saída padrão para gravar informações, erro ou mensagens de depuração, opcionalmente, eles poderão ser salvos em um bucket do Amazon S3 na sua conta da Amazon Web Services.
**Topics**
+ [Executar scripts antes de iniciar sessões de streaming](run-scripts-before-streaming-sessions-begin.md)
+ [Executar scripts após sessões de streaming](run-scripts-after-streaming-sessions-end.md)
+ [Criar e especificar scripts de sessão](create-specify-session-scripts.md)
+ [Arquivo de configuração de scripts de sessão](session-script-configuration-file.md)
+ [Usando PowerShell arquivos do Windows](using-powershell-files-with-session-scripts.md)
+ [Registro da saída do script de sessão](logging-session-output.md)
+ [Usar conectores de armazenamento com scripts de sessão](use-storage-connectors-with-session-scripts.md)
+ [Habilitar o armazenamento de buckets do Amazon S3 para logs de script de sessão](enable-S3-bucket-storage-session-script-logs.md)
+ [Usar scripts de sessão em frotas multissessão](session-scripts-multi-session-fleets.md)
# Executar scripts antes de iniciar sessões de streaming
Você pode configurar seus scripts para serem executados, no máximo, 60 segundos antes de iniciar aplicativos de seus usuários e as sessões de streaming começarem. Isso permite que você personalize o ambiente de WorkSpaces aplicativos antes que os usuários comecem a transmitir seus aplicativos. Quando os scripts de sessão forem executados, um símbolo giratório de carregamento será exibido para os usuários. Quando os scripts forem concluídos ou o tempo de espera máximo expirar, a sessão de streaming dos usuários começará. Se seus scripts não forem concluídos, uma mensagem de erro será exibida para os usuários. No entanto, os usuários não podem usar a sessão de streaming.
Ao especificar um nome de arquivo em uma instância do Windows, você deve usar duas barras invertidas. Por exemplo:
C:\$1\$1Scripts\$1\$1Myscript.bat
Se você não usar uma barra invertida dupla, um erro será exibido para notificá-lo de que o arquivo.json está formatado incorretamente.
**nota**
Quando os scripts forem concluídos, eles deverão retornar um valor 0. Se seus scripts retornarem um valor diferente de 0, os WorkSpaces Aplicativos exibirão a mensagem de erro para o usuário.
Quando você executa scripts antes do início das sessões de streaming e a estrutura dinâmica de WorkSpaces aplicativos não está habilitada, ocorre o seguinte processo:
![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)
1. Seus usuários se conectam a uma instância da frota de WorkSpaces aplicativos que não está associada ao domínio. Eles se conectam usando um dos seguintes métodos de acesso:
+ WorkSpaces Pool de usuários de aplicativos
+ SAML 2.0
+ WorkSpaces API de aplicativos
1. O catálogo de aplicativos é exibido no portal de WorkSpaces aplicativos e seus usuários escolhem um aplicativo para iniciar.
1. Acontecerá um dos cenários a seguir:
+ Se a persistência de configurações de aplicativo estiver habilitada para os usuários, o arquivo de disco rígido virtual (VHD) que armazena as personalizações dos usuários e configurações do Windows será baixado e montado. Nesse caso, é necessário que o usuário faça login no Windows.
Para obter informações sobre persistência de configurações de aplicativo, consulte [Ative a persistência das configurações do aplicativo para os usuários de seus WorkSpaces aplicativos](app-settings-persistence.md).
+ Se a persistência de configurações de aplicativo não estiver habilitada, o usuário do Windows já está conectado.
1. Os scripts de sessão são iniciados. Se o armazenamento persistente estiver habilitado para os usuários, a montagem do conector de armazenamento também será iniciada. Para obter informações sobre armazenamento persistente, consulte [Habilite e administre o armazenamento persistente para os usuários de seus WorkSpaces aplicativos](persistent-storage.md).
**nota**
A montagem do conector de armazenamento não precisa terminar para a sessão de streaming iniciar. Se os scripts de sessão forem concluídos antes que a montagem do conector de armazenamento termine, a sessão de streaming será iniciada.
Para obter informações sobre como monitorar o status de montagem de conectores de armazenamento, consulte [Usar conectores de armazenamento com scripts de sessão](use-storage-connectors-with-session-scripts.md).
1. Os scripts de sessão terminam ou atingem o tempo limite.
1. A sessão de streaming dos usuários é iniciada.
1. O aplicativo que seus usuários escolheram é iniciado.
Para obter informações sobre a estrutura de WorkSpaces aplicativos dinâmicos de aplicativos, consulte[Use o WorkSpaces Applications Dynamic Application Framework para criar um provedor de aplicativos dinâmico](build-dynamic-app-provider.md).
Quando você executa scripts antes do início das sessões de streaming e a estrutura dinâmica de WorkSpaces aplicativos é ativada, ocorre o seguinte processo:
![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)
1. Seus usuários visitam o portal de aplicativos SAML 2.0 da sua organização e escolhem a pilha de WorkSpaces aplicativos.
1. Eles se conectam a uma instância da frota de WorkSpaces aplicativos que está associada a um domínio.
1. Se a persistência de configurações de aplicativo estiver habilitada para os usuários, o arquivo VHD que armazena as personalizações dos usuários e configurações do Windows será baixado e montado.
1. O login de usuário do Windows ocorre.
1. O catálogo de aplicativos é exibido no portal de WorkSpaces aplicativos e seus usuários escolhem um aplicativo para iniciar.
1. Os scripts de sessão são iniciados. Se o armazenamento persistente estiver habilitado para os usuários, a montagem do conector de armazenamento também será iniciada.
**nota**
A montagem do conector de armazenamento não precisa terminar para a sessão de streaming iniciar. Se os scripts de sessão forem concluídos antes que a montagem do conector de armazenamento termine, a sessão de streaming será iniciada.
Para obter informações sobre como monitorar o status de montagem de conectores de armazenamento, consulte [Usar conectores de armazenamento com scripts de sessão](use-storage-connectors-with-session-scripts.md).
1. Os scripts de sessão terminam ou atingem o tempo limite.
1. A sessão de streaming dos usuários é iniciada.
1. O aplicativo que seus usuários escolheram é iniciado.
# Executar scripts após sessões de streaming
Você também pode configurar seus scripts para execução após sessões de streaming dos usuários. Por exemplo, você pode executar um script quando os usuários **selecionam Encerrar sessão** na barra de ferramentas de WorkSpaces aplicativos ou quando atingirem a duração máxima permitida para a sessão. Você também pode usar esses scripts de sessão para limpar seu ambiente de WorkSpaces aplicativos antes que uma instância de streaming seja encerrada. Por exemplo, você pode usar scripts para liberar bloqueios de arquivo ou fazer upload de arquivos de log. Quando você executar scripts após sessões de streaming, o seguinte processo ocorrerá:
![\[Flowchart showing WorkSpaces Applications session termination process with scripts and storage actions.\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/images/session-scripts-termination.png)
1. A sessão de streaming de WorkSpaces aplicativos de seus usuários termina.
1. Os scripts de encerramento de sessão são iniciados.
1. Os scripts de encerramento de sessão terminam ou atingem o tempo limite.
1. O logout de usuário do Windows ocorre.
1. Um ou os dois itens a seguir ocorrem em paralelo, se aplicável:
+ Se a persistência das configurações de aplicações estiver habilitada para os usuários, o arquivo VHD das configurações de aplicações que armazena as personalizações dos usuários e as configurações do Windows será desmontado e carregado em um bucket do Amazon S3 em sua conta.
+ Se o armazenamento persistente estiver habilitado para os usuários, o conector de armazenamento fará uma sincronização final e será desmontado.
1. A instância de frota é encerrada.
# Criar e especificar scripts de sessão
Você pode configurar e especificar scripts de sessão para frotas sempre ativas, sob demanda e elásticas.
**Como configurar e especificar scripts de sessão para frotas sempre ativas e sob demanda**
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)**, **Image Builder (Criador de imagens)**.
1. Escolha um criador de imagens que esteja no estado **Running (Em execução)** e selecione **Connect (Conectar)**.
1. Quando solicitado, escolha **Administrator (Administrador)**.
1. Navegue até `C:\AppStream\SessionScripts` e abra o arquivo de configuração `config.json`.
Para obter mais informações sobre parâmetros de script de sessão, consulte [Arquivo de configuração de scripts de sessão](session-script-configuration-file.md).
1. Depois de fazer as alterações, salve e feche o arquivo `config.json`.
1. Na área de trabalho do construtor de imagens, abra o **Assistente de Imagens**.
1. (Opcional) Especifique todas as outras aplicações que deseja incluir na imagem.
1. Siga as etapas necessárias no Image Assistant para concluir a criação da sua imagem.
Se a configuração de scripts de sessão não puder ser validada (por exemplo, se o arquivo .json não estiver formatado corretamente), você será notificado quando escolher **Disconnect and create image (Desconectar e criar imagem)**.
**nota**
Para encontrar o arquivo de configuração dos scripts de sessão para construtores de imagens baseados em Linux, navegue até `/opt/appstream/SessionScripts/config.json`.
**Como configurar e especificar scripts de sessão para frotas elásticas**
1. Crie um arquivo zip que contém os scripts de sessão e o arquivo config.json. Os arquivos de scripts serão copiados para os locais a seguir. Você deve usar esses locais para o arquivo config.json.
+ Para Windows, use `C:\AppStream\SessionScripts\SessionScript`.
+ Para Linux, use `/opt/appstream/SessionScripts/SessionScript`.
**nota**
Para executar os arquivos de script de sessão, garanta que o arquivo .zip contenha somente os scripts de sessão e os arquivos `config.json`, e não a pasta que os contém. Para obter mais informações, consulte [Arquivo de configuração de scripts de sessão](session-script-configuration-file.md).
1. Faça upload do arquivo zip em um bucket do Amazon S3 em sua conta.
**nota**
Sua VPC deve fornecer acesso ao bucket do Amazon S3. Para obter mais informações, consulte [Usando endpoints VPC do Amazon S3 para recursos de aplicativos WorkSpaces](managing-network-vpce-iam-policy.md).
Você deve ter seu bucket S3 e sua frota de WorkSpaces aplicativos no mesmo Região da AWS.
Você deve ter permissões do IAM para realizar a ação `S3:GetObject` no objeto dos scripts de sessão no bucket do Amazon S3. Para saber mais sobre como armazenar os scripts de sessão em um bucket do Amazon S3, consulte [Armazenar o ícone da aplicação, o script de configuração, o script de sessão e o VHD em um bucket do S3](store-s3-bucket.md).
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, escolha **Fleets**.
1. Escolha uma frota elástica para atualizar, depois selecione **Exibir detalhes**.
1. Na guia **Configurações de scripts de sessão**, escolha **Editar**.
1. Em **Objeto de scripts de sessão no S3**, insira o URI do S3 que representa o objeto dos scripts de sessão ou escolha **Procurar no S3** para navegar até seus buckets do S3 e encontrar o objeto dos scripts de sessão.
1. Quando terminar de fazer as alterações, escolha **Salvar alterações**.
1. Os scripts de sessão já estão disponíveis para todas as instâncias de frota lançadas.
**nota**
Você também pode configurar os scripts da sessão ao criar uma frota elástica.
# Arquivo de configuração de scripts de sessão
Para localizar o arquivo de configuração dos scripts de sessão em uma instância do Windows, navegue até C:\$1\$1 AppStreamSessionScripts\$1 config.json. Em uma instância Linux, navegue até/opt/appstream/SessionScripts/config.json. O arquivo é formatado da maneira a seguir.
**nota**
O arquivo de configuração está no formato .json. Verifique se qualquer texto que você digitar nesse arquivo está no formato .json válido.
```
{
"SessionStart": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
},
"SessionTermination": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
}
}
```
Você pode usar os seguintes parâmetros no arquivo de configuração de scripts de sessão.
***SessionStart/SessionTermination ***
Os scripts de sessão devem ser executados no evento de sessão apropriado com base no nome do objeto.
**Tipo:** string
**Obrigatório**: não
**Valores permitidos:** **SessionStart**, **SessionTermination**
***WaitingTime***
A duração máxima dos scripts de sessão em segundos.
**Tipo**: inteiro
**Obrigatório**: não
**Restrições:** a duração máxima é de 60 segundos. Se os scripts de sessão não forem concluídos dentro desse período, eles serão interrompidos. Se você precisar que um script continue em execução, inicie-o como um processo separado.
***Executables***
Os detalhes dos scripts de sessão para executar.
**Tipo:** string
**Obrigatório**: Sim
**Restrições:** o número máximo de scripts que podem ser executados por evento de sessão é 2 (um para o contexto do usuário e um para o contexto do sistema).
***Context***
O contexto no qual executar o script de sessão.
**Tipo:** string
**Obrigatório**: Sim
**Valores permitidos:** **user**, **system**
***Filename***
O caminho completo para o script de sessão a ser executado. Se esse parâmetro não for especificado, o script de sessão não será executado.
**Tipo:** string
**Obrigatório**: não
**Restrições:** o comprimento máximo do nome do arquivo e do caminho completo é 1.000 caracteres.
**Valores permitidos:** **.bat**, **.exe**, **.sh**
Você também pode usar PowerShell arquivos do Windows. Para obter mais informações, consulte [Usando PowerShell arquivos do Windows](using-powershell-files-with-session-scripts.md).
***Arguments***
Os argumentos do script de sessão ou arquivo executável.
**Tipo:** string
**Obrigatório**: não
**Restrições de tamanho**: o comprimento máximo é de 1.000 caracteres.
***S3LogEnabled***
Quando o valor desse parâmetro for definido como **True**, um bucket do S3 será criado em sua conta da Amazon Web Services para armazenar os logs criados pelo script de sessão. Por padrão, esse valor é definido como **True**. Para obter mais informações, consulte a seção *Registro da saída do script de sessão* mais adiante neste tópico.
**Tipo**: booliano
**Obrigatório**: não
**Valores permitidos:** **True**, **False**
# Usando PowerShell arquivos do Windows
Para usar PowerShell arquivos do Windows, especifique o caminho completo para o PowerShell arquivo no **filename** parâmetro:
```
"filename":
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
```
Em seguida, especifique seu script de sessão no parâmetro **arguments**:
```
"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",
```
Por fim, verifique se a Política de PowerShell Execução permite que seu PowerShell arquivo seja executado.
# Registro da saída do script de sessão
Quando essa opção é ativada no arquivo de configuração, os WorkSpaces aplicativos capturam automaticamente a saída do script de sessão que é gravado na saída padrão. Essa saída é carregada em um bucket do Amazon S3 em sua conta. Você pode analisar os arquivos de log para solução de problemas ou para fins de depuração.
**nota**
Os arquivos de log são carregados quando o script de sessão retorna um valor ou o valor definido em **WaitingTime** é atingido, o que ocorrer primeiro.
# Usar conectores de armazenamento com scripts de sessão
Quando os conectores de armazenamento de WorkSpaces aplicativos estão habilitados, eles começam a ser montados quando os scripts de início da sessão são executados. Se seu script depende da montagem dos conectores de armazenamento, você pode esperar que os conectores estejam disponíveis. WorkSpaces Os aplicativos mantêm o status de montagem dos conectores de armazenamento no registro do Windows em instâncias do Windows, na seguinte chave:
HKEY\$1LOCAL\$1MACHINE\$1 SOFTWARE\$1 Amazon\$1\$1 Storage\$1\$1 AppStream
Os valores de chave de registro são os seguintes:
+ Nome de usuário fornecido: o ID de usuário fornecido por meio do modo de acesso. Os modos de acesso e um valor para cada modo são os seguintes:
+ Grupo de usuários: o endereço de e-mail do usuário.
+ URL de streaming: o UserID.
+ SAML: o NameID. Se o nome do usuário incluir uma barra (por exemplo, o SAMAccount nome de um usuário do domínio), a barra será substituída por um caractere “-”.
+ Conector de armazenamento: o conector habilitado para a opção de armazenamento persistente do usuário. Os valores de conector de armazenamento são os seguintes:
+ HomeFolder
+ GoogleDrive
+ OneDrive
Cada chave de registro do conector de armazenamento contém um valor **MountStatus**DWORD. A tabela a seguir lista os valores possíveis para **MountStatus**.
**nota**
Para visualizar essas chaves de registro, é necessário ter o Microsoft .NET Framework versão 4.7.2 ou posterior instalado em sua imagem.
| Valor | Description |
| --- | --- |
| 0 | Conector de armazenamento não ativado para esse usuário |
| 1 | A montagem do conector de armazenamento está em andamento |
| 2 | Conector de armazenamento montado com êxito |
| 3 | Falha na montagem do conector de armazenamento |
| 4 | A montagem do conector de armazenamento está habilitada, mas ainda não ocorreu |
Em instâncias Linux, você pode verificar o status de montagem da pasta inicial observando o valor de appstream\$1home\$1folder\$1mount\$1status no arquivo \$1/. config/appstream-home-folder/appstream-home-folder-mount-status.
| Valor | Description |
| --- | --- |
| Verdadeiro | Pasta base montada com sucesso |
| Falso | Pasta base ainda não está montada |
# Habilitar o armazenamento de buckets do Amazon S3 para logs de script de sessão
Quando você ativa o login do Amazon S3 na configuração do script da sessão, os WorkSpaces aplicativos capturam a saída padrão do script da sessão. A saída é carregada periodicamente em um bucket do S3 na sua conta da Amazon Web Services. Para cada AWS região, o WorkSpaces Applications cria um bucket em sua conta que é exclusivo para sua conta e para a região.
Você não precisa executar tarefas para gerenciar esses buckets do S3. Eles são totalmente gerenciados pelo serviço de WorkSpaces aplicativos. Os arquivos de log armazenados em cada bucket são criptografados em trânsito usando endpoints SSL do Amazon S3 e em repouso usando chaves de criptografia gerenciadas pelo Amazon S3. Os buckets são nomeados em um formato específico da seguinte forma:
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
***region-code***
Esse é o código da AWS região em que a pilha é criada com o armazenamento de bucket do Amazon S3 habilitado para logs de script de sessão.
***account-id-without-hyphens***
O identificador de sua conta da Amazon Web Services. O ID aleatório garante que não haja conflitos com outros buckets na região. A primeira parte do nome do bucket, `appstream-logs`, não é alterada entre contas ou regiões.
Por exemplo, se você especificar scripts de sessão em uma imagem na região Oeste dos EUA (Oregon) (us-west-2) na conta número 123456789012 WorkSpaces , os aplicativos criarão um bucket Amazon S3 dentro da sua conta nessa região com o nome exibido. Somente um administrador com permissões suficientes pode excluir esse bucket.
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
Desabilitar os scripts de seção não exclui nenhum arquivo de log armazenado no bucket do S3. Para excluir permanentemente os arquivos de log, você ou outro administrador com permissões adequadas deve fazer isso usando o console ou a API do Amazon S3. WorkSpaces Os aplicativos adicionam uma política de bucket que evita a exclusão acidental do bucket. Para obter mais informações, consulte a seção *Políticas do IAM e do bucket da Amazon S3 para persistência de configurações do aplicativo* em [Identity and Access Management para WorkSpaces aplicativos da Amazon](controlling-access.md).
Quando os scripts de sessão são habilitados, uma pasta exclusiva é criada para cada sessão de streaming que é iniciada.
O caminho para a pasta em que os arquivos de log são armazenados no bucket do S3 em sua conta usa a seguinte estrutura:
```
bucket-name/stack-name/fleet-name/access-mode/user-id-SHA-256-hash/session-id/SessionScriptsLogs/session-event
```
***bucket-name***
O nome do bucket do S3 no qual os scripts de sessão são armazenados. O formato do nome é descrito anteriormente nesta seção.
***stack-name***
O nome da pilha da qual a sessão veio.
***fleet-name***
O nome da frota em que o script de sessão está sendo executado.
***access-mode***
O método de identidade do usuário: `custom` para a API ou CLI de WorkSpaces aplicativos, `federated` para SAML e `userpool` para usuários no grupo de usuários.
***user-id-SHA-256-hash***
O nome da pasta específica do usuário. Esse nome é criado usando um hash hexadecimal SHA-256 em minúsculas gerado a partir da string de identificador de usuário.
***session-id***
O identificador da sessão de streaming do usuário. Cada sessão de streaming de usuário gera um ID exclusivo.
***session-event***
O evento que gerou o log de script de sessão. Os valores de evento são: `SessionStart` e `SessionTermination`.
A estrutura da pasta de exemplo a seguir aplica-se a uma sessão de streaming iniciada na pilha de teste e na frota de teste. A sessão usa a API de ID de usuário`testuser@mydomain.com`, de um Conta da AWS ID de`123456789012`, e o grupo de configurações `test-stack` na região Oeste dos EUA (Oregon) (us-west-2):
```
appstream-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/
```
Essa estrutura de pasta de exemplo contém um arquivo de log para um script de início de sessão do contexto do usuário e um arquivo de log para um script de início de sessão do contexto do sistema, se aplicável.
# Usar scripts de sessão em frotas multissessão
Ao usar scripts de sessão em frotas multissessão, há requisitos e considerações adicionais para garantir o desempenho e a segurança ideais.
## Requisitos
Em uma frota de sessão única, em uma determinada instância, é garantido que os **SessionTermination**ganchos **SessionStart**e funcionem apenas uma vez. Isso ocorre porque há um mapeamento 1:1 de sessões para instâncias. Ao usar frotas de várias sessões, há um mapeamento N:M de sessões para instâncias, em que cada sessão é executada por conta própria e gancho. **SessionStart**SessionTermination**** Isso significa que os **SessionTermination**ganchos **SessionStart**e podem ser executados várias vezes em uma determinada instância e em muitas ordens diferentes. Para obter a melhor experiência, o seguinte deve ser válido para seus scripts de sessão quando usados em frotas multissessão:
+ Os scripts são idempotentes.
Quando uma ação já tiver sido executada, os scripts deverão lidar com mais de uma execução na mesma instância com um tratamento adequado.
+ Os scripts são independentes.
Como os scripts são executados por sessão, se uma sessão estiver sendo executada **SessionTermination**enquanto outra estiver em execução **SessionStart**, eles não devem interferir uns com os outros ou com a experiência de outras sessões.
+ Os scripts são performantes.
Em instâncias multissessão, várias sessões podem ser provisionadas simultaneamente. Isso significa que pode haver várias execuções simultâneas dos scripts de sessão. Os scripts devem ser eficientes, não consumir recursos excessivos e não afetar a experiência de outros usuários na instância ou a estabilidade das sessões.
Muitos desses requisitos podem ser atendidos mantendo a lógica do script de sessão focada na sessão específica do usuário para a qual o script está sendo executado.
## Considerações sobre segurança
WorkSpaces As imagens dos aplicativos não devem ser configuradas para permitir a permissão de gravação em arquivos de script de sessão por nenhum usuário. Isso introduz um vetor de ataque crítico para usuários mal-intencionados, onde eles podem modificar arquivos de script. Esses arquivos podem ser executados como SYSTEM ou outro usuário, dependendo da sua configuração.
**Importante**
É sua responsabilidade garantir que as imagens de seus WorkSpaces aplicativos sejam configuradas com segurança. Isso é especialmente importante para instâncias multissessão, em que vários usuários estão usando a mesma instância. Se as imagens não forem configuradas de maneira segura, haverá um risco de segurança para todos os usuários dessa instância.
O seguinte deve ser verdadeiro para suas imagens e arquivos de scripts de sessão:
+ Os usuários não têm permissão para modificar arquivos de script de sessão.
+ Os usuários não têm permissão para modificar o config.json do script de sessão. O comportamento padrão na imagem restringe o acesso aos administradores.
Os executáveis dos scripts de sessão devem ser armazenados em um local seguro, onde não possam ser modificados no runtime.
Se o serviço detectar que um script de sessão executável foi modificado, ele falhará em todas as execuções subsequentes desse hook nessa instância, carregará os arquivos de log no Amazon S3 (se o log do Amazon S3 estiver habilitado) e você verá a seguinte mensagem:
**O script da sessão não foi executado porque o executável foi modificado após o provisionamento da instância. A execução foi ignorada por motivos de segurança.**
Se o seu caso de uso exigir a modificação do executável do script de sessão no runtime (por exemplo, se você apontar para um arquivo EXE que é modificado por um processo de atualização automática no runtime), isso falhará nas verificações acima. Nesse caso, use um script para redirecionar a execução para seu executável modificado. Deixe o script inalterado no runtime quando o serviço realizar verificações de segurança.
Se os arquivos de script de sessão forem muito grandes (mais de 100 MB), isso poderá causar atrasos no provisionamento de instâncias e sessões, e as verificações de segurança levarão mais tempo (dependendo do tipo de instância e dos recursos disponíveis). Se o seu caso de uso exigir scripts de sessão grandes, considere usar scripts menores para redirecionar a execução. Isso melhorará as experiências de provisionamento de instâncias e sessões.
Observe que o serviço está verificando apenas o executável definido nos scripts de sessão config.json, e isso é apenas um mecanismo de esforço. fallback/best É sua responsabilidade garantir que todos os caminhos de código nos executáveis dos scripts de sessão sejam seguros e não possam ser modificados pelos usuários finais.