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á.
# Pacotes e imagens para piscinas WorkSpaces
Um *WorkSpace pacote* é uma combinação de um sistema operacional e recursos de armazenamento, computação e software. Ao lançar um WorkSpace, você seleciona o pacote que atende às suas necessidades. Os pacotes padrão disponíveis para WorkSpaces são chamados de *pacotes públicos*. Para obter mais informações sobre os vários pacotes públicos disponíveis WorkSpaces, consulte [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles).
Se você iniciou um Windows WorkSpace e o personalizou, você pode criar uma imagem personalizada a partir dele WorkSpace para uso com o WorkSpaces Pool. O Linux não é suportado no WorkSpaces Pool.
Uma *imagem personalizada* contém somente o sistema operacional, o software e as configurações do WorkSpace. Um *pacote personalizado* é uma combinação dessa imagem personalizada e do hardware a partir do qual um WorkSpace pode ser iniciado.
Depois de criar uma imagem personalizada, você pode criar um pacote personalizado que combina a WorkSpace imagem personalizada e a configuração subjacente de computação e armazenamento selecionada. Em seguida, você pode especificar esse pacote personalizado ao criar novos WorkSpaces pools para garantir que os novos WorkSpaces no pool tenham a mesma configuração consistente (hardware e software).
Se precisar realizar atualizações de software ou instalar software adicional no seu WorkSpaces, você pode atualizar seu pacote personalizado e usá-lo para reconstruir seu. WorkSpaces
WorkSpaces Os pools oferecem suporte a vários sistemas operacionais (SO), protocolos de streaming e pacotes diferentes. A tabela a seguir fornece informações sobre licenciamento, protocolos de streaming e pacotes compatíveis com cada sistema operacional.
| Sistema operacional | Licenças | Protocolos de streaming | Pacotes compatíveis | Política de ciclo de vida/data de retirada |
| --- | --- | --- | --- | --- |
| Windows Server 2019 | Incluído | DCV | Valor, padrão, desempenho, potência, PowerPro | [9 de janeiro de 2029](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2019) |
| Windows Server 2022 | Incluído | DCV | Padrão, desempenho, potência, PowerPro gráficos.G4dn, .G4dn GraphicsPro | [14 de outubro de 2031](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2022) |
**nota**
As versões do sistema operacional que não são mais suportadas pelo fornecedor não têm garantia de funcionamento e não são suportadas pelo AWS suporte.
**Topics**
+ [Opções de pacote para WorkSpaces Pools](pools-custom-images-bundles.md)
+ [Crie uma imagem e um pacote personalizados para piscinas WorkSpaces](pools-images-custom-image.md)
+ [Gerencie imagens e pacotes personalizados para piscinas WorkSpaces](pools-images-managing.md)
+ [Usar scripts de sessão para gerenciar a experiência de streaming dos usuários](pools-images-session-scripts.md)
# Opções de pacote para WorkSpaces Pools
Antes de selecionar um pacote para usar com o WorkSpaces Pool, garanta que ele é compatível com o protocolo, o sistema operacional, a rede e o tipo de computação do seu WorkSpaces. Recomendamos testar a performance dos pacotes que você deseja escolher em um ambiente de teste, executando e usando aplicações que repliquem as tarefas diárias dos usuários. Para obter mais informações sobre protocolos, consulte [Protocolos para WorkSpaces uso pessoal](amazon-workspaces-networking.md#amazon-workspaces-protocols). Para obter mais informações sobre redes consulte [Requisitos de rede de clientes do WorkSpaces Personal](workspaces-network-requirements.md).
Os pacotes públicos a seguir podem ser usados com o WorkSpaces Pool. Para obter informações sobre pacotes do WorkSpaces, consulte [Pacotes do Amazon WorkSpaces](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Value, Standard, Performance, Power, PowerPro
## Pacote Value
Esse pacote é ideal para:
+ Edição básica de texto e entrada de dados
+ Navegação na web com uso leve
+ Mensagens instantâneas
Esse pacote não é recomendado para processamento de texto, audioconferência, videoconferência, compartilhamento de tela, ferramenta de desenvolvimento de software, aplicações de business intelligence e aplicações gráficas.
## Pacote Standard
Esse pacote é ideal para:
+ Edição básica de texto e entrada de dados
+ Navegação na web
+ Mensagens instantâneas
+ E-mail
Esse pacote não é recomendado para audioconferência, videoconferência, compartilhamento de tela, processamento de texto, ferramenta de desenvolvimento de software, aplicações de business intelligence e aplicações gráficas
## Pacote Performance
Esse pacote é ideal para:
+ Navegação na web
+ Processamento de texto
+ Mensagens instantâneas
+ E-mail
+ Planilhas
+ Processamento de áudio
+ Material didático eletrônico
Esse pacote não é recomendado para videoconferência, compartilhamento de tela, ferramenta de desenvolvimento de software, aplicações de business intelligence e aplicações gráficas
## Pacote Power
Esse pacote é ideal para:
+ Navegação na web
+ Processamento de texto
+ E-mail
+ Mensagens instantâneas
+ Planilhas
+ Processamento de áudio
+ Desenvolvimento de software (ambiente de desenvolvimento integrado [IDE])
+ Processamento de dados em nível básico e médio
+ Audioconferência e videoconferência
Esse pacote não é recomendado para compartilhamento de tela, ferramenta de desenvolvimento de software, aplicações de business intelligence e aplicações gráficas.
## Pacote PowerPro
Esse pacote é ideal para:
+ Navegação na web
+ Processamento de texto
+ E-mail
+ Mensagens instantâneas
+ Planilhas
+ Processamento de áudio
+ Desenvolvimento de software (ambiente de desenvolvimento integrado [IDE])
+ Data warehousing
+ Aplicações de business intelligence
+ Audioconferência e videoconferência
Esse pacote não é recomendado para treinamento de modelos de machine learning e aplicações gráficas
## Pacote Graphics.g4dn
Esse pacote oferece um alto nível de performance gráfica e um nível moderado de performance de CPU e memória para WorkSpaces, sendo ideal para:
+ Navegação na web
+ Processamento de texto
+ E-mail
+ Planilhas
+ Mensagens instantâneas
+ Audioconferência
+ Desenvolvimento de software (ambiente de desenvolvimento integrado [IDE])
+ Processamento de dados em nível básico e médio
+ Data warehousing
+ Aplicações de business intelligence
+ Design gráfico
+ CAD/CAM (projeto auxiliado por computador/manufatura auxiliada por computador)
Esse pacote não é recomendado para audioconferência, videoconferência, renderização 3D, design fotorrealista e treinamento de modelos de machine learning
## Pacote GraphicsPro.g4dn
Esse pacote oferece um alto nível de performance gráfica, performance de CPU e memória para WorkSpaces, sendo ideal para:
+ Navegação na web
+ Processamento de texto
+ E-mail
+ Planilhas
+ Mensagens instantâneas
+ Audioconferência
+ Desenvolvimento de software (ambiente de desenvolvimento integrado [IDE])
+ Processamento de dados em nível básico e médio
+ Data warehousing
+ Aplicações de business intelligence
+ Design gráfico
+ CAD/CAM (projeto auxiliado por computador/manufatura auxiliada por computador)
+ Transcodificação de vídeo
+ Renderização 3D
+ Design fotorrealista
+ Streaming de jogos
+ Treinamento de modelos de machine learning (ML) inferência de ML
Esse pacote não é recomendado para audioconferência e videoconferência.
# Crie uma imagem e um pacote personalizados para piscinas WorkSpaces
WorkSpaces O Pool suporta somente imagens e pacotes do Windows. Se você lançou um Windows ou WorkSpace o personalizou, você pode criar uma imagem personalizada e pacotes personalizados a partir dele. WorkSpace
Uma *imagem personalizada* contém somente o sistema operacional, o software e as configurações do WorkSpace. Um *pacote personalizado* é uma combinação dessa imagem personalizada e do hardware a partir do qual um WorkSpace pode ser iniciado.
Depois de criar uma imagem personalizada, será possível criar um pacote personalizado que combine a imagem personalizada e a configuração de computação e armazenamento subjacente selecionada. Em seguida, você pode especificar esse pacote personalizado ao iniciar um novo WorkSpaces para garantir que o novo WorkSpaces tenha a mesma configuração consistente (hardware e software).
É possível usar a mesma imagem personalizada para criar vários pacotes personalizados selecionando diferentes opções de computação e armazenamento para cada pacote.
**Importante**
Os volumes de armazenamento de pacotes personalizados não podem ser menores do que os volumes de armazenamento de imagens.
Os pacotes personalizados custam o mesmo que os pacotes públicos pelos quais são criados. Para obter mais informações sobre preços, consulte [Amazon WorkSpaces Pricing](https://aws.amazon.com/workspaces/pricing/).
**Topics**
+ [Requisitos para criar imagens personalizadas do Windows](#pools-windows_custom_image_requirements)
+ [Práticas recomendadas](#pools-custom_image_best_practices)
+ [Etapa 1: Executar o Verificador de Imagens](#pools-run_image_checker)
+ [Etapa 2: criar uma imagem personalizada e um pacote personalizado](#pools-create_custom_image_bundle)
+ [O que está incluído nas imagens WorkSpaces personalizadas do Windows](#pools-image_creation_windows)
## Requisitos para criar imagens personalizadas do Windows
**nota**
Atualmente, o Windows define 1 GB como 1.073.741.824 bytes. Você deve garantir que eles tenham mais de 12.884.901.888 bytes (ou 12 GiB) livres na unidade C e que o perfil do usuário tenha menos de 10.737.418.240 bytes (ou 10 GiB) para criar uma imagem de a. WorkSpace
+ O status do WorkSpace deve ser **Disponível** e seu estado de modificação deve ser **Nenhum**.
+ Todos os aplicativos e perfis de usuário em WorkSpaces imagens devem ser compatíveis com o Microsoft Sysprep.
+ Todas as aplicações a serem incluídas na imagem devem ser instaladas na unidade `C`.
+ Todos os serviços de aplicativos executados no WorkSpace devem usar uma conta do sistema local em vez de credenciais de usuário do domínio. Por exemplo, você não pode ter uma instalação do Microsoft SQL Server Express em execução com as credenciais de um usuário do domínio.
+ Eles não WorkSpace devem ser criptografados. A criação de imagens a partir de uma imagem criptografada não WorkSpace é suportada atualmente.
+ Os componentes a seguir são necessários em uma imagem. Sem esses componentes, o WorkSpaces que você inicia a partir da imagem não funcionará corretamente. Para obter mais informações, consulte [Componentes de configuração e serviço necessários para o WorkSpaces Personal](required-service-components.md).
+ Windows PowerShell versão 3.0 ou posterior
+ Serviços de desktop remoto
+ AWS Controladores fotovoltaicos
+ Gerenciamento remoto do Windows (WinRM)
+ Agentes e motoristas da Teradici PCo IP
+ Agentes e drivers do STXHD
+ AWS e WorkSpaces certificados
+ Agente do Skylight
+ WorkSpaces Os pools suportam apenas um tamanho máximo de volume raiz de pacote/imagem de 200 GB. Ao criar uma imagem personalizada do Windows, verifique se ela está abaixo do tamanho do volume raiz de 200 GB.
## Práticas recomendadas
Antes de criar uma imagem a partir de um WorkSpace, faça o seguinte:
+ Use uma VPC separada que não esteja conectada ao ambiente de produção.
+ Implemente o WorkSpace em uma sub-rede privada e use uma instância NAT para tráfego de saída.
+ Use um pequeno diretório do Simple AD.
+ Use o menor tamanho de volume para a fonte e WorkSpace, em seguida, ajuste o tamanho do volume conforme necessário ao criar o pacote personalizado.
+ Instale todas as atualizações do sistema operacional (exceto as atualizações de recursos/versões do Windows) e todas as atualizações de aplicativos no. WorkSpace
+ Exclua dados em cache do WorkSpace que não devem ser incluídos no pacote (por exemplo, histórico do navegador, arquivos em cache e cookies do navegador).
+ Exclua as configurações WorkSpace que não devem ser incluídas no pacote (por exemplo, perfis de e-mail).
+ Alterne para configurações de endereço IP dinâmico usando DHCP.
+ Verifique se você não excedeu sua cota de WorkSpace imagens permitidas em uma região. Por padrão, você tem permissão para 40 WorkSpace imagens por região. Se você atingiu essa cota, ocorrerão falhas em novas tentativas de criar uma imagem. Para solicitar um aumento de cota, use o [formulário Limites do WorkSpaces ](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=workspaces).
+ Verifique se você não está tentando criar uma imagem a partir de uma imagem criptografada WorkSpace. A criação de imagens a partir de uma imagem criptografada não WorkSpace é suportada atualmente.
+ Se você estiver executando algum software antivírus no WorkSpace, desative-o enquanto estiver tentando criar uma imagem.
+ Se você tiver um firewall habilitado no seu WorkSpace, verifique se ele não está bloqueando nenhuma porta necessária. Para obter mais informações, consulte [Requisitos de endereço IP e porta para o WorkSpaces Personal](workspaces-port-requirements.md).
+ Para Windows WorkSpaces, não configure nenhum Objeto de Política de Grupo (GPOs) antes da criação da imagem.
+ Para Windows WorkSpaces, não personalize o perfil de usuário padrão (`C:\Users\Default`) antes de criar uma imagem. Recomendamos fazer todas as personalizações no perfil do usuário e aplicá-las após a criação da imagem. GPOs GPOs podem ser facilmente modificadas ou revertidas e, portanto, são menos propensas a erros do que as personalizações feitas no perfil de usuário padrão.
+ Certifique-se de atualizar os drivers de dependência de rede, como ENA, NVMe, e drivers PV em seu. WorkSpaces Você deve fazer isso pelo menos uma vez a cada 6 meses. Para obter mais informações, consulte [Install or upgrade Elastic Network Adapter (ENA) driver ](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/enhanced-networking-ena.html#ena-adapter-driver-install-upgrade-win), [Drivers do AWS NVMe for Windows instances](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/aws-nvme-drivers.html) e [Upgrade PV drivers on Windows instances](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html).
+ Certifique-se de atualizar periodicamente os agentes EC2 Config, EC2 Launch e EC2 Launch V2 para as versões mais recentes. Você deve fazer isso pelo menos uma vez a cada 6 meses. Para obter mais informações, consulte [Update EC2 Config and EC2](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/migrating-latest-types.html#upgdate-ec2config-ec2launch) Launch.
## Etapa 1: Executar o Verificador de Imagens
Para confirmar se o Windows WorkSpace atende aos requisitos de criação de imagens, recomendamos executar o aplicativo Image Checker. O Image Checker executa uma série de testes sobre o WorkSpace que você deseja usar para criar sua imagem e fornece orientação sobre como resolver quaisquer problemas encontrados. O Image Checker está disponível somente para Windows WorkSpaces.
**Importante**
Eles WorkSpace devem passar por todos os testes executados pelo Image Checker antes de poder usá-lo para criar imagens.
Antes de executar o Image Checker, verifique se as atualizações cumulativas e de segurança mais recentes do Windows estão instaladas no seu. WorkSpace
Para obter o Verificador de Imagens, siga um destes procedimentos:
+ [Reinicie seu. WorkSpace](reboot-workspaces.md) O Verificador de imagens é baixado automaticamente durante a reinicialização e instalado em `C:\Program Files\Amazon\ImageChecker.exe`.
+ Faça o download do Amazon WorkSpaces Image Checker em [https://tools.amazonworkspaces.comImageChecker/.zip ](https://tools.amazonworkspaces.com/ImageChecker.zip) e extraia o arquivo. `ImageChecker.exe` Copie esse arquivo em `C:\Program Files\Amazon\`.
**Como executar o Verificador de Imagens**
1. Abra o arquivo `C:\Program Files\Amazon\ImageChecker.exe`.
1. Na caixa de diálogo **Amazon WorkSpaces Image Checker**, escolha **Executar**.
1. Após a conclusão de cada teste, você pode visualizar o status do teste.
Para qualquer teste com o status **Com falha**, selecione **Informações** para exibir informações sobre como resolver o problema que provocou a falha. Para obter mais informações sobre como resolver esses problemas, consulte [Dicas para resolver problemas detectados pelo Verificador de Imagens](#pools-image_checker_tips).
Se algum teste exibir o status **AVISO**, selecione o botão **Corrigir todos os avisos**.
A ferramenta gera um arquivo de log de saída no mesmo diretório onde o Verificador de Imagens está localizado. Por padrão, esse arquivo está localizado em `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`. Não exclua esse arquivo de log. Se ocorrer um problema, esse arquivo de log poderá ser útil na solução de problemas.
1. Se aplicável, resolva quaisquer problemas que causem falhas e avisos no teste e repita o processo de execução do Image Checker até que WorkSpace ele passe em todos os testes. Todas as falhas e avisos devem ser resolvidos para que você possa criar uma imagem.
1. Depois de WorkSpace passar em todos os testes, você verá uma mensagem de **validação bem-sucedida**. Agora você está pronto para criar um pacote personalizado.
### Dicas para resolver problemas detectados pelo Verificador de Imagens
Além de consultar as dicas a seguir para resolver problemas detectados pelo Verificador de imagens, verifique o arquivo de log do Verificador de imagens em `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`.
#### PowerShell a versão 3.0 ou posterior deve ser instalada
Instale a versão mais recente do [Microsoft Windows PowerShell](https://docs.microsoft.com/powershell).
**Importante**
A política de PowerShell execução de um WorkSpace deve ser definida para permitir **RemoteSigned**scripts. Para verificar a política de execução, execute o ExecutionPolicy PowerShell comando **Get-**. Se a política de execução não estiver definida como **Irrestrita** ou **RemoteSigned**, execute o ExecutionPolicy RemoteSigned comando **Set- ExecutionPolicy —** para alterar o valor da política de execução. A **RemoteSigned**configuração permite a execução de scripts na Amazon WorkSpaces, o que é necessário para criar uma imagem.
#### Somente as unidades C e D podem estar presentes
Somente as `D` unidades `C` e podem estar presentes em uma WorkSpace que é usada para geração de imagens. Remova todas as outras unidades, incluindo unidades virtuais.
#### Nenhuma reinicialização pendente devido às atualizações do Windows pode ser detectada
+ O processo de criação de imagem não pode ser executado até que o Windows seja reinicializado para concluir a instalação de atualizações de segurança ou cumulativas. Reinicie o Windows para aplicar essas atualizações e certifique-se de que nenhuma outra atualização de segurança ou cumulativa do Windows precise ser instalada.
+ A criação de imagens não é suportada em sistemas Windows 10 que foram atualizados de uma versão do Windows 10 para uma versão mais recente do Windows 10 (uma feature/version atualização do Windows). No entanto, as atualizações cumulativas ou de segurança do Windows são suportadas pelo processo de criação de WorkSpaces imagens.
#### O arquivo Sysprep deve existir e não pode estar em branco
Se houver problemas com seu arquivo Sysprep, entre em contato com o [AWS Support Centro para reparar](https://console.aws.amazon.com/support/home#/) seu EC2 Config ou Launch. EC2
#### O tamanho do perfil do usuário deve ser inferior a 10 GB
Para o Windows 7 WorkSpaces, o perfil do usuário (`D:\Users\username`) deve ter menos de 10 GB no total. Remova os arquivos conforme necessário para reduzir o tamanho do perfil do usuário.
#### A unidade C deve ter espaço livre suficiente
Para o Windows 7 WorkSpaces, você deve ter pelo menos 12 GB de espaço livre na unidade`C`. Remova os arquivos conforme necessário para liberar espaço na unidade `C`. Para o Windows 10 WorkSpaces, ignore se você receber uma `FAILED` mensagem e o espaço em disco estiver acima de 2 GB.
#### Nenhum serviço pode estar em execução em uma conta de domínio
Para executar o processo de criação de imagem, nenhum serviço no WorkSpace pode ser executado em uma conta de domínio. Todos os serviços devem estar em execução em uma conta local.
**Como executar serviços em uma conta local**
1. Abra `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log` e localize a lista de serviços que estão em execução em uma conta de domínio.
1. Na caixa de pesquisa do Windows, digite **services.msc** para abrir o Gerenciador de Serviços do Windows.
1. Em **Fazer login como**, procure os serviços que estão em execução em contas de domínio. (Os serviços executados como **Sistema local**, **Local Service Serviço local** ou **Serviço de rede** não interferem na criação de imagens.)
1. Selecione um serviço que esteja em execução em uma conta de domínio e escolha **Ação**, **Propriedades**.
1. Abra a guia **Fazer login**. Em **Fazer login como**, escolha **Conta do sistema local**.
1. Escolha **OK**.
#### O WorkSpace deve ser configurado para usar DHCP
Você deve configurar todos os adaptadores de rede no WorkSpace para usar DHCP em vez de endereços IP estáticos.
**Como definir todos os adaptadores de rede para usar DHCP**
1. Na caixa de pesquisa do Windows, digite **control panel** para abrir o Painel de Controle.
1. Escolha **Rede e Internet**.
1. Escolha **Central de Rede e Compartilhamento**.
1. Escolha **Alterar as configurações do adaptador** e selecione um adaptador.
1. Escolha **Alterar as configurações desta conexão**.
1. **Na guia **Rede**, selecione **Protocolo de Internet Versão 4 (TCP/IPv4)** e escolha Propriedades.**
1. Na caixa de diálogo **Propriedades do Protocolo de Internet Versão 4 (TCP/IPv4)**, selecione **Obter um endereço IP automaticamente**.
1. Escolha **OK**.
1. Repita esse processo para todos os adaptadores de rede no WorkSpace.
#### Os Serviços de área de trabalho remota devem estar habilitados
O processo de criação de imagem requer que os Serviços de área de trabalho remota sejam habilitados.
**Como habilitar os Serviços de área de trabalho remota**
1. Na caixa de pesquisa do Windows, digite **services.msc** para abrir o Gerenciador de Serviços do Windows.
1. Na coluna **Nome** localize **Serviços de área de trabalho remota**.
1. Selecione **Serviços de área de trabalho remota** e, depois, escolha **Ação**, **Propriedades**.
1. Na guia **Geral**, em **Tipo de inicialização**, escolha **Manual** ou **Automático**.
1. Escolha **OK**.
#### Deve existir um perfil do usuário
O WorkSpace que você está usando para criar imagens deve ter um perfil de usuário (`D:\Users\username`). Se ocorrer uma falha nesse teste, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/) para obter assistência.
#### O caminho da variável de ambiente deve ser configurado corretamente
O caminho da variável de ambiente para a máquina local não tem entradas para System32 e para Windows PowerShell. Essas entradas são necessárias para a execução do processo de criação de imagem.
**Como configurar o caminho da variável de ambiente**
1. Na caixa de pesquisa do Windows, insira **environment variables** e escolha **Editar as variáveis de ambiente do sistema**.
1. Na caixa de diálogo **Propriedades do sistema**, abra a guia **Avançado** e escolha **Variáveis de ambiente**.
1. Na caixa de diálogo **Variáveis de ambiente**, em **Variáveis de sistema**, selecione a entrada **Caminho** e escolha **Editar**.
1. Escolha **Novo** e adicione o seguinte caminho:
`C:\Windows\System32`
1. Escolha **Novo** novamente e adicione o seguinte caminho:
`C:\Windows\System32\WindowsPowerShell\v1.0\`
1. Escolha **OK**.
1. Reinicie WorkSpace o.
**dica**
A ordem em que os itens aparecem no caminho da variável de ambiente é importante. Para determinar a ordem correta, talvez você queira comparar o caminho da sua variável de ambiente WorkSpace com um de uma instância recém-criada WorkSpace ou nova do Windows.
#### O instalador de módulos do Windows deve estar habilitado
O processo de criação de imagem requer que o serviço Instalador de módulos do Windows esteja habilitado.
**Como habilitar o serviço Instalador de módulos do Windows**
1. Na caixa de pesquisa do Windows, digite **services.msc** para abrir o Gerenciador de Serviços do Windows.
1. Na coluna **Nome**, localize **Instalador de módulos do Windows**.
1. Selecione **Instalador de módulos do Windows** e, depois, escolha **Ação**, **Propriedades**.
1. Na guia **Geral**, em **Tipo de inicialização**, escolha **Manual** ou **Automático**.
1. Escolha **OK**.
#### O Amazon SSM Agent deve ser desativado
O processo de criação de imagem requer que o serviço Amazon SSM Agent seja desativado.
**Como desabilitar o serviço Amazon SSM Agent**
1. Na caixa de pesquisa do Windows, digite **services.msc** para abrir o Gerenciador de Serviços do Windows.
1. Na coluna **Nome**, localize o **Amazon SSM Agent**.
1. Selecione **Amazon SSM Agent** e, depois, escolha **Ação**, **Propriedades**.
1. Na guia **Geral**, em **Tipo de inicialização**, escolha **Desativado**.
1. Escolha **OK**.
#### SSL3 e a versão 1.2 do TLS deve estar ativada
Para configurar SSL/TLS para Windows, consulte [Como habilitar o TLS 1.2](https://docs.microsoft.com/configmgr/core/plan-design/security/enable-tls-1-2) na documentação do Microsoft Windows.
#### Somente um perfil de usuário pode existir no WorkSpace
Só pode haver um perfil de WorkSpaces usuário (`D:\Users\username`) no WorkSpace que você está usando para criar imagens. Exclua todos os perfis de usuário que não pertençam ao usuário pretendido do WorkSpace.
Para que a criação de imagens funcione, você só WorkSpace pode ter três perfis de usuário nela:
+ O perfil de usuário do usuário pretendido do WorkSpace (`D:\Users\username`)
+ O perfil do usuário padrão (também conhecido como perfil padrão)
+ O perfil do usuário Administrador
Se houver perfis do usuário adicionais, será possível excluí-los por meio das propriedades avançadas do sistema no Painel de Controle do Windows.
**Como excluir um perfil do usuário**
1. Para acessar as propriedades avançadas do sistema, siga um destes procedimentos:
+ Pressione a tecla Windows\$1Pause Break e escolha Configurações avançadas do sistema no painel esquerdo da caixa de diálogo Painel de Controle > Sistema e Segurança > Sistema.
+ Na caixa de pesquisa do Windows, digite **control panel**. No Painel de Controle, escolha Sistema e Segurança, escolha Sistema e, depois, selecione **Configurações avançadas do sistema** no painel esquerdo da caixa de diálogo **Painel de Controle** > **Sistema e Segurança** > **Sistema**.
1. Na caixa de diálogo **Propriedades do sistema** na guia **Avançado** escolha **Configurações** em **Perfis do usuário**.
1. Se houver algum perfil listado que não seja o perfil do administrador, o perfil padrão e o perfil do WorkSpaces usuário pretendido, selecione esse perfil adicional e escolha **Excluir**.
1. Quando perguntado se deseja excluir o perfil, escolha **Sim**.
1. Se necessário, repita as etapas 3 e 4 para remover quaisquer outros perfis que não pertençam ao WorkSpace.
1. Escolha **OK** duas vezes e feche o Painel de Controle.
1. Reinicie WorkSpace o.
#### Nenhum pacote AppX pode estar em um estado de preparo
Um ou mais pacotes AppX estão em um estado de preparo. Isso pode causar um erro de Sysprep durante a criação da imagem.
**Como remover todos os pacotes do AppX preparados**
1. Na caixa de pesquisa do Windows, digite **powershell**. Escolha **Executar como administrador**.
1. Quando perguntado “Deseja permitir que este aplicativo faça alterações no dispositivo?”, escolha **Sim**.
1. Na PowerShell janela do Windows, digite os seguintes comandos para listar todos os pacotes AppX preparados e pressione Enter após cada um.
```
$workSpaceUserName = $env:username
```
```
$allAppxPackages = Get-AppxPackage -AllUsers
```
```
$packages = $allAppxPackages | Where-Object { `
(($_.PackageUserInformation -like "*S-1-5-18*" -and !($_.PackageUserInformation -like "*$workSpaceUserName*")) -and `
($_.PackageUserInformation -like "*Staged*" -or $_.PackageUserInformation -like "*Installed*")) -or `
((!($_.PackageUserInformation -like "*S-1-5-18*") -and $_.PackageUserInformation -like "*$workSpaceUserName*") -and `
$_.PackageUserInformation -like "*Staged*")
}
```
1. Execute o comando a seguir com privilégios SYSTEM elevados para remover todas as entradas de provisionamento do pacote AppX preparadas e pressione Enter.
```
$packages | Remove-AppxPackage -ErrorAction SilentlyContinue
```
1. Execute o Verificador de imagens novamente. Se este teste ainda falhar, digite os comandos a seguir para remover todos os pacotes AppX e pressione Enter após cada um.
```
Get-AppxProvisionedPackage -Online | Remove-AppxProvisionedPackage -Online -ErrorAction SilentlyContinue
```
```
Get-AppxPackage -AllUsers | Remove-AppxPackage -ErrorAction SilentlyContinue
```
#### O Windows não pode ter sido atualizado de uma versão anterior
A criação de imagens não é suportada em sistemas Windows que foram atualizados de uma versão do Windows 10 para uma versão mais recente do Windows 10 (uma feature/version atualização do Windows).
Para criar imagens, use uma WorkSpace que não tenha passado por uma feature/version atualização do Windows.
#### A contagem de rearmação do Windows não deve ser 0
O atributo rearmar permite que você estenda o período de ativação para a versão de avaliação do Windows. O processo de criação de imagem requer que a contagem de rearmação seja um valor diferente de 0.
**Como verificar a contagem de rearmação do Windows**
1. No menu **Iniciar** do Windows, escolha **Sistema Windows** e selecione **Prompt de comando**.
1. Na janela Prompt de comando, digite o comando a seguir e depois pressione Enter.
`cscript C:\Windows\System32\slmgr.vbs /dlv`
Para redefinir a contagem de rearmação como um valor diferente de 0, consulte [ Sysprep (Generalize) uma instalação do Windows](https://docs.microsoft.com/windows-hardware/manufacture/desktop/sysprep--generalize--a-windows-installation) na documentação do Microsoft Windows.
#### Outras dicas de solução de problemas
Se você WorkSpace passar em todos os testes executados pelo Image Checker, mas ainda não conseguir criar uma imagem a partir do WorkSpace, verifique os seguintes problemas:
+ Certifique-se de que WorkSpace não esteja atribuído a um usuário dentro de um grupo de **convidados do domínio**. Para verificar se há alguma conta de domínio, execute o PowerShell comando a seguir.
```
Get-WmiObject -Class Win32_Service | Where-Object { $_.StartName -like "*$env:USERDOMAIN*" }
```
+ Alguns Objetos de Política de Grupo (GPOs) restringem o acesso à impressão digital do certificado RDP quando ela é solicitada pelo serviço EC2 Config ou pelos scripts EC2 Launch durante a configuração da instância do Windows. Antes de tentar criar uma imagem, mova-a WorkSpace para uma nova unidade organizacional (OU) com herança bloqueada e não GPOs aplicada.
+ Verifique se o serviço Gerenciamento Remoto do Windows (WinRM) está configurado para ser iniciado automaticamente. Faça o seguinte:
1. Na caixa de pesquisa do Windows, digite `services.msc` para abrir o Gerenciador de Serviços do Windows.
1. Na coluna **Nome** localize **Gerenciamento Remoto do Windows (WS-Management)**.
1. Selecione **Gerenciamento Remoto do Windows (WS-Management)** e escolha **Ação**, **Propriedades**.
1. Na guia **Geral**, em **Tipo de inicialização**, escolha **Automático**.
1. Escolha **OK**.
## Etapa 2: criar uma imagem personalizada e um pacote personalizado
Depois de validar sua WorkSpace imagem, conclua o procedimento a seguir para criar sua imagem personalizada e seu pacote personalizado usando o WorkSpaces console. Para criar uma imagem programaticamente, use a ação da CreateWorkspaceImage API. Para obter mais informações, consulte [ CreateWorkspaceImage](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceImage.html)a *Amazon WorkSpaces API Reference*. Para criar um pacote de forma programática, use a ação da API **CreateWorkspaceBundle**. Para obter mais informações, consulte [ CreateWorkspaceBundle](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceBundle.html)a *Amazon WorkSpaces API Reference*.
**Para criar uma imagem personalizada e um pacote personalizado usando o console WorkSpaces**
1. Se você ainda estiver conectado ao WorkSpace, desconecte escolhendo **Amazon WorkSpaces** e **Disconnect** no aplicativo WorkSpaces cliente.
1. Abra o WorkSpaces console em [https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home).
1. No painel de navegação, escolha **WorkSpaces**.
1. Selecione a WorkSpace para abrir sua página de detalhes e escolha **Criar imagem**. Se o status do WorkSpace for **Parado**, você deverá iniciá-lo primeiro (escolha **Ações**, **Iniciar WorkSpaces**) antes de escolher **Ações**, **Criar imagem**.
1. Uma mensagem é exibida solicitando que você reinicie (reinicie) o seu WorkSpace antes de continuar. Reiniciando suas WorkSpace atualizações, seu WorkSpaces software Amazon para a versão mais recente.
Reinicie o seu WorkSpace fechando a mensagem e seguindo as etapas em[Reinicializar um WorkSpace no WorkSpaces Personal](reboot-workspaces.md). Quando terminar, repita a [Step 4](create-custom-bundle.md#step_create_image) desse procedimento, mas desta vez selecione **Próximo** quando a mensagem de reinicialização for exibida. Para criar uma imagem, o status do WorkSpace deve ser **Disponível** e seu estado de modificação deve ser **Nenhum**.
1. Insira um nome de imagem e uma descrição que o ajudarão a identificar a imagem e escolha **Criar imagem**. Enquanto a imagem está sendo criada, o status do WorkSpace é **Suspenso** e indisponível. WorkSpace
Não use um caractere especial traço (`-`) na descrição. Isso causará um erro.
1. No painel de navegação, selecione **Imagens**. A imagem estará completa quando o status das WorkSpace alterações for alterado para **Disponível** (isso pode levar até 45 minutos).
1. Selecione a imagem e escolha **Ações**, **Criar pacote**.
1. Insira o nome de um pacote e uma descrição. Depois, faça o seguinte:
+ Para o **tipo de hardware de pacote**, escolha o hardware a ser usado ao iniciar WorkSpaces a partir desse pacote personalizado.
+ As combinações de tamanho padrão disponíveis para o volume raiz são 200 GB por WorkSpace.
1. Para confirmar que o pacote foi criado, escolha **Pacotes** e verifique se o pacote está listado.
## O que está incluído nas imagens WorkSpaces personalizadas do Windows
Quando você cria uma imagem a partir de um Windows WorkSpace, todo o conteúdo da `C` unidade é incluído.
+ Contatos
+ Downloads
+ Música
+ Imagens
+ Jogos salvos
+ Vídeos
+ Podcasts
+ Máquinas virtuais
+ .virtualbox
+ Rastreamento
+ appdata\$1local\$1temp
+ appdata\$1roaming\$1apple computer\$1mobilesync\$1
+ appdata\$1roaming\$1apple computer\$1logs\$1
+ appdata\$1roaming\$1apple computer\$1itunes\$1iphone software updates\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1macromedia.com\$1support\$1flashplayer\$1sys\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1\$1sharedobjects\$1
+ appdata\$1roaming\$1adobe\$1flash player\$1assetcache\$1
+ appdata\$1roaming\$1microsoft\$1windows\$1recent\$1
+ appdata\$1roaming\$1microsoft\$1office\$1recent\$1
+ appdata\$1roaming\$1microsoft office\$1live meeting
+ appdata\$1roaming\$1microsoft shared\$1livemeeting shared\$1
+ appdata\$1roaming\$1mozilla\$1firefox\$1crash reports\$1
+ appdata\$1roaming\$1mcafee\$1common framework\$1
+ appdata\$1local\$1microsoft\$1feeds cache
+ appdata\$1local\$1microsoft\$1windows\$1temporary internet files\$1
+ appdata\$1local\$1microsoft\$1windows\$1history\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1iconcache\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1recovery\$1
+ appdata\$1local\$1mozilla\$1firefox\$1profiles\$1
# Gerencie imagens e pacotes personalizados para piscinas WorkSpaces
O processo para gerenciar imagens e pacotes personalizados é o mesmo entre WorkSpaces Personal e WorkSpaces Pool. Para obter mais informações sobre como gerenciar imagens e pacotes, consulte a documentação a seguir na seção WorkSpaces Pessoal deste guia:
**nota**
A principal diferença entre os pacotes personalizados que você pode usar para o WorkSpaces Personal e os que você pode usar para o WorkSpaces Pool é o sistema operacional e o pacote público básico que podem ser usados. Para os sistemas operacionais e pacotes compatíveis com o WorkSpaces Pool, consulte[ WorkSpaces Pacotes de piscinasBundles Saiba mais sobre os pacotes WorkSpaces Pools. Um *WorkSpace pacote* é uma combinação de um sistema operacional e recursos de armazenamento, computação e software. Ao lançar um WorkSpace, você seleciona o pacote que atende às suas necessidades. Os pacotes padrão disponíveis para WorkSpaces são chamados de *pacotes públicos*. Para obter mais informações sobre os vários pacotes públicos disponíveis WorkSpaces, consulte [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). A tabela a seguir fornece informações sobre licenciamento, protocolos de streaming e pacotes compatíveis com cada sistema operacional.
| Sistema operacional | Licenças | Protocolos de streaming | Pacotes compatíveis |
| --- | --- | --- | --- |
| Windows Server 2019 | Incluído | DCV | Valor, padrão, desempenho, potência, PowerPro |
| Windows Server 2022 | Incluído | DCV | Padrão, desempenho, potência, PowerPro gráficos.G4dn, .G4dn GraphicsPro | As versões do sistema operacional que não são mais suportadas pelo fornecedor não têm garantia de funcionamento e não são suportadas pelo AWS suporte. ](instance-types.md#instance-types.title).
+ [Atualizar um pacote personalizado para o WorkSpaces Personal](update-custom-bundle.md).
+ [Copiar uma imagem personalizada em WorkSpaces Pessoal](copy-custom-image.md).
+ [Compartilhar ou cancelar o compartilhamento de uma imagem personalizada do WorkSpaces Personal](share-custom-image.md).
+ [Excluir uma imagem ou um pacote personalizado no WorkSpaces Personal](delete_bundle.md).
# Usar scripts de sessão para gerenciar a experiência de streaming dos usuários
WorkSpaces O pool fornece 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 pools 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 WorkSpace imagem. 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)
+ [Executar scripts após sessões de streaming](#run-scripts-after-streaming-sessions-end)
+ [Criar e especificar scripts de sessão](#create-specify-session-scripts)
+ [Arquivo de configuração de scripts de sessão](#session-script-configuration-file)
+ [Usando PowerShell arquivos do Windows](#using-powershell-files-with-session-scripts)
+ [Registro da saída do script de sessão](#logging-session-output)
+ [Use armazenamento persistente com scripts de sessão](#use-storage-connectors-with-session-scripts)
+ [Habilitar o armazenamento de buckets do Amazon S3 para logs de script de sessão](#enable-S3-bucket-storage-session-script-logs)
## 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 pools 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:\\Scripts\\Myscript.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, WorkSpaces exibirá a mensagem de erro para o usuário.
Quando você executar scripts após sessões de streaming, o seguinte processo ocorrerá:
1. Seus usuários se conectam a um WorkSpace WorkSpaces pool que não está associado a um domínio. Eles se conectam usando o SAML 2.0.
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 seus usuários de WorkSpaces Pools](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 [Habilitar e administrar o armazenamento persistente para pools WorkSpaces](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 [Use armazenamento persistente com scripts de sessão](#use-storage-connectors-with-session-scripts).
1. Os scripts de sessão terminam ou atingem o tempo limite.
1. A sessão de streaming dos usuários é iniciada.
## 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 do WorkSpaces cliente 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 o ambiente do WorkSpaces 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á:
1. A sessão de WorkSpaces streaming dos 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. O WorkSpace está encerrado.
## Criar e especificar scripts de sessão
Conclua o procedimento a seguir para criar e especificar scripts de sessão para você WorkSpaces em um WorkSpaces pool.
1. Conecte-se ao Windows a WorkSpaces partir do qual você está criando uma imagem personalizada.
1. Crie o diretório `/AWSEUC/SessionScripts` caso ele ainda não exista.
1. Crie um arquivo de configuração `/AWSEUC/SessionScripts/config.json` caso ele ainda não exista, usando o [modelo de configuração do script de sessão](https://docs.aws.amazon.com/workspaces/latest/adminguide/pools-images-session-scripts.html#session-script-configuration-file).
1. Navegue até `C:\AWSEUC\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).
1. Depois de fazer as alterações, salve e feche o arquivo `config.json`.
1. Conclua as etapas para criar uma imagem a partir do WorkSpace. Para obter mais informações, consulte [Crie uma imagem e um pacote personalizados para piscinas WorkSpaces](pools-images-custom-image.md).
## 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:\AWSEUC\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).
**`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 está habilitada no arquivo de configuração, o WorkSpaces Pool captura 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.
## Use armazenamento persistente com scripts de sessão
Quando o armazenamento WorkSpaces persistente está ativado, o armazenamento começa a ser montado quando os scripts de início da sessão são executados. Se seu script depende da montagem do armazenamento persistente, você pode esperar que os conectores estejam disponíveis. WorkSpaces mantém o status de montagem dos conectores de armazenamento no registro do Windows no Windows WorkSpaces, na seguinte chave:
```
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\AWSEUC\Storage\\
```
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
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 |
## 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, o WorkSpaces Pool captura 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 Pool 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 WorkSpaces serviço. 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:
```
wspool-logs---random-identifier
```
**``**
Esse é o código da AWS região em que o WorkSpaces pool é criado com o armazenamento de bucket do Amazon S3 habilitado para logs de script de sessão.
**``**
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, `wspool-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`) no número da conta`123456789012`, o WorkSpaces Pool cria 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.
```
wspool-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 pools adicionam uma política de bucket que evita a exclusão acidental do bucket.
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:
```
//////SessionScriptsLogs/
```
******
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.
******
O nome da pilha da qual a sessão veio.
******
O nome do WorkSpaces Pool em que o script da sessão está sendo executado.
******
O método de identidade do usuário: `custom` para a WorkSpaces API ou CLI, `federated` para SAML e `userpool` para usuários no grupo de usuários.
******
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.
******
O identificador da sessão de streaming do usuário. Cada sessão de streaming de usuário gera um ID exclusivo.
******
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 do ID do 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`):
```
wspool-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.