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

# Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos
<a name="tutorial-image-builder"></a>

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
<a name="tutorial-image-builder-install"></a>

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
<a name="tutorial-image-builder-add"></a>

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
<a name="tutorial-image-builder-create-default-app-settings"></a>

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
<a name="tutorial-image-builder-test-applications"></a>

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
<a name="tutorial-image-builder-optimize"></a>

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
<a name="tutorial-image-builder-finish-create-image"></a>

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
<a name="tutorial-image-builder-tag-copy"></a>

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
<a name="tutorial-image-builder-finish"></a>

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