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á.
# Ative a persistência das configurações do aplicativo para seus usuários de WorkSpaces Pools
WorkSpaces Os pools oferecem suporte a configurações persistentes de aplicativos para diretórios baseados no Windows. Isso significa que as personalizações de aplicativos dos usuários e configurações do Windows são salvas automaticamente após cada sessão de streaming e aplicados durante a próxima sessão. Exemplos de configurações persistentes do aplicativo que os usuários podem configurar incluem, entre outros, favoritos do navegador, configurações, sessões de página da web, perfis de conexão de aplicativos, plug-ins e personalizações de interface. Essas configurações são salvas em um bucket do Amazon Simple Storage Service (Amazon S3) em sua conta, dentro da região na qual a persistência AWS das configurações do aplicativo está habilitada. Eles estão disponíveis em cada sessão de streaming do WorkSpaces Pools.
**nota**
Cobranças padrão do Amazon S3 podem ser aplicadas a dados armazenados no bucket do S3. Para obter mais informações, consulte [Preços do Amazon S3](https://aws.amazon.com/s3/pricing/).
**Topics**
+ [Como a persistência de configurações de aplicativo funciona](how-it-works-app-settings-persistence.md)
+ [Como habilitar a persistência de configurações de aplicativo](enabling-app-settings-persistence.md)
+ [Administre as configurações do aplicativo VHDs para seus usuários](administer-app-settings-vhds.md)
# Como a persistência de configurações de aplicativo funciona
Configurações persistentes de aplicativo são salvas em um arquivo de disco rígido virtual (VHD). Esse arquivo é criado na primeira vez que o usuário transmite um aplicativo de um diretório em que a persistência de configurações de aplicativo é habilitada. Se o WorkSpace Pool associado ao diretório for baseado em uma imagem que contém configurações padrão do aplicativo e do Windows, as configurações padrão serão usadas para a primeira sessão de streaming do usuário.
Quando a sessão de streaming termina, o VHD é desmontado e carregado em um bucket do Amazon S3 dentro de sua conta. O bucket é criado quando você ativa as configurações persistentes do aplicativo pela primeira vez para um diretório em uma AWS região. O bucket é exclusivo para sua AWS conta e para a região. [O VHD é criptografado em trânsito usando endpoints SSL do Amazon S3 e em repouso usando Managed.AWS CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)
O VHD é montado WorkSpace em ambos `C:\Users\%username%` e. `D:\%username%` Se você não WorkSpace estiver associado a um domínio do Active Directory, o nome de usuário do Windows será PhotonUser. Se você WorkSpace estiver associado a um domínio do Active Directory, o nome de usuário do Windows será o do usuário conectado.
A persistência de configurações de aplicativo não funciona em versões de sistemas operacionais diferentes. Por exemplo, se você habilitar a persistência das configurações do aplicativo para um WorkSpace Pool que usa uma imagem do Windows Server 2019, se você atualizar o WorkSpace Pool para usar uma imagem que executa um sistema operacional diferente (como o Windows Server 2022), as configurações das sessões de streaming anteriores não serão salvas para os usuários do diretório. Em vez disso, depois de atualizar o WorkSpace Pool para usar a nova imagem, quando os usuários iniciam uma sessão de streaming a partir de um WorkSpace, um novo perfil de usuário do Windows é criado. No entanto, se você aplicar uma atualização para o mesmo sistema operacional da imagem, as personalizações dos usuários e as configurações de sessões de streaming anteriores serão salvas. Quando as atualizações do mesmo sistema operacional são aplicadas a uma imagem, o mesmo perfil de usuário do Windows é usado quando os usuários iniciam uma sessão de streaming a partir do WorkSpace.
**Importante**
WorkSpaces Os pools oferecem suporte a aplicativos que dependem da [API de Proteção de Dados da Microsoft](https://docs.microsoft.com/en-us/windows/desktop/seccng/cng-dpapi) somente quando associados WorkSpace a um domínio do Microsoft Active Directory. Nos casos em que a não WorkSpace está associado a um domínio do Active Directory, o usuário do Windows, PhotonUser, é diferente em cada um WorkSpace. Devido à maneira como o modelo de segurança da DPAPI funciona, as senhas dos usuários não persistem para aplicativos que usam a DPAPI nesse cenário. Nos casos em que WorkSpaces estão associados a um domínio do Active Directory e o usuário é um usuário do domínio, o nome de usuário do Windows é o do usuário conectado e as senhas dos usuários persistem para aplicativos que usam DPAPI.
WorkSpaces Os pools salvam automaticamente todos os arquivos e pastas nesse caminho, exceto as seguintes pastas:
+ Contatos
+ Área de Trabalho
+ Documentos
+ Downloads
+ Links
+ Imagens
+ Jogos salvos
+ Pesquisas
+ Vídeos
Os arquivos e pastas criados fora dessas pastas são salvos no VHD e sincronizados ao Amazon S3. O tamanho máximo de VHD padrão é 5 GB para Pools. O tamanho do VHD salvo é o tamanho total dos arquivos e pastas que ele contém. WorkSpaces Os pools salvam automaticamente a `HKEY_CURRENT_USER` seção de registro para o usuário. Para novos usuários (usuários cujos perfis não existem no Amazon S3), o WorkSpaces Pools cria o perfil inicial usando o perfil padrão. Esse perfil é criado no seguinte local no construtor de imagens: `C:\users\default`.
**nota**
O VHD inteiro deve ser baixado para o WorkSpace antes que uma sessão de streaming possa começar. Por esse motivo, um VHD que contém uma grande quantidade de dados pode atrasar o início da sessão de streaming. Para obter mais informações, consulte [Melhores práticas para habilitar a persistência de configurações de aplicativo](enabling-app-settings-persistence.md#best-practices-app-settings-persistence).
Quando você habilitar a persistência de configurações do aplicativo, você deve especificar um grupo de configurações. O grupo de configurações determina quais configurações salvas do aplicativo são usadas para uma sessão de streaming desse diretório. WorkSpaces Os pools criam um novo arquivo VHD para o grupo de configurações que é armazenado separadamente no bucket do S3 em sua AWS conta. Se o grupo de configurações for compartilhado entre diretórios, as mesmas configurações do aplicativo são usadas em cada diretório. Se um diretório exigir suas próprias configurações de aplicativo, especifique um grupo de configurações exclusivo para o diretório.
# Como habilitar a persistência de configurações de aplicativo
**Topics**
+ [Pré-requisitos para habilitar a persistência de configurações de aplicativo](#prerequisites-app-settings-persistence)
+ [Melhores práticas para habilitar a persistência de configurações de aplicativo](#best-practices-app-settings-persistence)
+ [Como habilitar persistência de configurações de aplicativo](#howto-enable-app-settings-persistence)
## Pré-requisitos para habilitar a persistência de configurações de aplicativo
Para habilitar a persistência de configurações do aplicativo, você deve primeiro fazer o seguinte:
+ Use uma imagem criada a partir de uma imagem base publicada AWS em ou após 7 de dezembro de 2017.
+ Habilite a conectividade de rede para o Amazon S3 da sua nuvem privada virtual (VPC) configurando o acesso à internet ou um endpoint da VPC para o Amazon S3. Para obter mais informações, consulte a seção *Pastas base e VPC endpoints* em [Redes e acesso para o WorkSpaces Pools](managing-network.md).
## Melhores práticas para habilitar a persistência de configurações de aplicativo
Para habilitar a persistência das configurações do aplicativo sem fornecer acesso à Internet WorkSpaces, use um VPC endpoint. Esse endpoint deve estar na VPC à qual WorkSpaces seus pools estão WorkSpaces conectados. Você deve anexar uma política personalizada para permitir que os WorkSpaces Pools acessem o endpoint. Para obter informações sobre como criar a política personalizada, consulte a seção *Pastas base e VPC endpoints* em [Redes e acesso para o WorkSpaces Pools](managing-network.md). Para obter mais informações sobre endpoints privados do Amazon S3, consulte [Conceitos do AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints.html) e [Endpoints de gateway para o Amazon S3](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-s3.html) no *Guia do usuário do Amazon VPC*.
## Como habilitar persistência de configurações de aplicativo
Você pode ativar ou desativar a persistência das configurações do aplicativo ao criar um diretório ou após a criação do diretório usando o WorkSpaces console. Para cada região da AWS , as configurações persistentes de aplicações são armazenadas em um bucket do S3 na sua conta.
Na primeira vez que você ativa a persistência das configurações do aplicativo para um diretório em uma AWS região, o WorkSpaces Pools cria um bucket do S3 em sua AWS conta na mesma região. O mesmo bucket armazena o arquivo VHD de configurações do aplicativo para todos os usuários e todos os diretórios dessa AWS região. Para obter mais informações, consulte *Amazon S3 Bucket Storage* em [Administre as configurações do aplicativo VHDs para seus usuários](administer-app-settings-vhds.md).
**Para habilitar persistência de configurações de aplicativo enquanto cria um diretório**
+ Siga as etapas em [Configure o SAML 2.0 e crie um diretório de WorkSpaces pools](create-directory-pools.md), e garanta que **Enable Application Settings Persistence (Habilitar persistência de configurações de aplicativo)** está selecionado.
**Para habilitar persistência de configurações de aplicativo para um diretório existente**
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 à esquerda, selecione **Pools** e selecione o pool para o qual habilitará a persistência do aplicativo.
1. Selecione **Edite** na seção de **Configurações** da página.
1. Na seção **Persistência do Aplicativo** da página, escolha **Habilitar persistência de configurações de aplicativo**.
1. Escolha **Salvar alterações**.
Novas sessões de streaming agora têm a persistência das configurações do aplicativo habilitada.
# Administre as configurações do aplicativo VHDs para seus usuários
**Topics**
+ [Armazenamento em bucket do Amazon S3](#app-persistence-s3-buckets)
+ [Redefinir as configurações de aplicativo de um usuário](#app-persistence-s3-reset)
+ [Habilitar o versionamento de objetos do Amazon S3 e reverter as configurações de aplicações do usuário](#app-persistence-enable-versions-revert-settings)
+ [Aumentar o tamanho das configurações de aplicativo VHD](#app-persistence-increase-VHD-size)
## Armazenamento em bucket do Amazon S3
Quando você ativa a persistência das configurações do aplicativo, as personalizações do aplicativo dos seus usuários e as configurações do Windows são salvas automaticamente em um arquivo de disco rígido virtual (VHD) que é armazenado em um bucket do Amazon S3 criado em sua conta. AWS Para cada AWS região, o WorkSpaces Pools cria um bucket em sua conta que é exclusivo para sua conta e para a região. Todas as configurações do aplicativo configurado por seus usuários são armazenadas no bucket dessa região.
Você não precisa realizar nenhuma tarefa de configuração para gerenciar esses buckets do S3; eles são totalmente gerenciados pelo serviço WorkSpaces Pools. [O arquivo VHD armazenado em cada bucket é criptografado em trânsito usando os endpoints SSL do Amazon S3 e em repouso usando o Managed.AWS CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) Os buckets são nomeados em um formato específico da seguinte forma:
```
wspool-app-settings---
```
***region-code***
Esse é o código da AWS região em que o diretório é criado com a persistência das configurações do aplicativo.
***account-id-without-hyphens***
O ID AWS da sua conta. O identificador aleatório garante que não haja conflitos com outros buckets na região. A primeira parte do nome do bucket, `wspool-app-settings`, não é alterada entre contas ou regiões.
Por exemplo, se você ativar a persistência das configurações do aplicativo para diretórios na região Oeste dos EUA (Oregon) (us-west-2) na conta número 123456789012, WorkSpaces Pools cria um bucket do 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-app-settings-us-west-2-1234567890123-abcdefg
```
A desativação da persistência das configurações do aplicativo não exclui nenhuma VHDs armazenada no bucket do S3. Para excluir permanentemente as configurações VHDs, 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 a persistência das configurações do aplicativo estiver habilitada, uma pasta exclusiva será criada para cada grupo de configurações para armazenar o VHD de configurações. A hierarquia da pasta no bucket do S3 depende de como o usuário ativa uma sessão de streaming, conforme descrito na seção a seguir.
O caminho para a pasta em que o VHD de configurações é armazenado no bucket do S3 em sua conta usa a seguinte estrutura:
```
bucket-name/Windows/prefix/settings-group/access-mode/user-id-SHA-256-hash
```
***bucket-name***
O nome do bucket do S3 no qual as configurações do aplicativo dos usuários são armazenadas. O formato do nome é descrito anteriormente nesta seção.
***prefix***
O prefixo específico da versão do Windows. Por exemplo, v4 para Windows Server 2012 R2.
***settings-group***
O valor do grupo de configurações. Esse valor é aplicado a um ou mais diretórios que compartilham as mesmas configurações do aplicativo.
***access-mode***
O método de identidade do usuário: `custom` para a API ou CLI de WorkSpaces grupos de grupos de usuários, `federated` para SAML e `userpool` para usuários de grupos 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 ID de usuário.
O exemplo de estrutura de pastas a seguir se aplica a uma sessão de streaming que é acessada usando a API ou a CLI com um ID de usuário`testuser@mydomain.com`, 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-app-settings-us-west-2-1234567890123-abcdefg/Windows/v4/test-stack/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13
```
Você pode identificar a pasta de um usuário gerando o valor de hash SHA-256 de ID de usuário em letras minúsculas usando sites ou bibliotecas de código aberto disponíveis online.
## Redefinir as configurações de aplicativo de um usuário
Para redefinir as configurações do aplicativo de um usuário, você deve encontrar e excluir o VHD e o arquivo de metadados associado do bucket do S3 em sua conta. AWS Certifique-se de não fazer isso durante uma sessão de streaming ativa do usuário. Depois de excluir o VHD do usuário e o arquivo de metadados, na próxima vez que o usuário iniciar uma sessão de uma instância de streaming com a persistência das configurações do aplicativo ativada, o WorkSpaces Pools criará um novo VHD de configurações para esse usuário.
**Para redefinir as configurações de aplicativo de um usuário**
1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Na lista **Nome do bucket**, escolha o nome do bucket do S3 que contém o VHD das configurações do aplicativo que você deseja redefinir.
1. Localize a pasta que contém o VHD. Para obter mais informações sobre como navegar na estrutura de pastas do bucket do S3, consulte *Armazenamento do bucket do Amazon S3* anteriormente neste tópico.
1. Na lista **Nome**, marque a caixa de seleção ao lado do VHD e REG, selecione **Mais** e **Excluir**.
1. Na caixa de diálogo **Excluir objetos**, verifique se o VHD e o REG estão listados e selecione **Excluir**.
Na próxima vez que o usuário transmitir de um pool em que a persistência de configurações de aplicativo está ativada com o pool de configurações aplicável, um novo VHD de configuração de aplicativo é criado. Este VHD é salvo no bucket do S3 no final da sessão.
## Habilitar o versionamento de objetos do Amazon S3 e reverter as configurações de aplicações do usuário
Você pode usar o versionamento de objetos e as políticas de ciclo de vida do Amazon S3 para gerenciar as configurações de aplicações do usuário quando os usuários as alteram. Com o versionamento de objetos do Amazon S3, você pode preservar, recuperar e restaurar cada versão do VHD de configurações. Isso permite que você se recupere de ações não intencionais de usuário e de falhas do aplicativo. Quando o versionamento é habilitado, após cada sessão de streaming, uma nova versão do VHD de configurações de aplicações é sincronizada ao Amazon S3. A nova versão não sobrepõe a versão anterior, então se ocorrer um problema com as configurações de seus usuários, você poderá reverter para uma versão anterior do VHD.
**nota**
Cada versão do VHD de configurações de aplicações é salva no Amazon S3 como um objeto separado e é cobrada de acordo.
O versionamento de objeto não está habilitado por padrão em seu bucket do S3, então você deve habilitá-lo de forma explicita.
**Para habilitar o versionamento de objeto para seu VHD de configurações de aplicativo**
1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Na lista **Nome do bucket**, escolha o bucket do S3 que contém o VHD de configurações do aplicativo para o qual deseja habilitar o versionamento de objeto.
1. Escolha **Properties**.
1. Escolha **Versionamento** ou **Habilitar versionamento** e, em seguida, escolha **Salvar**.
Para expirar versões mais antigas das configurações do seu aplicativo VHDs, você pode usar as políticas de ciclo de vida do Amazon S3. Para obter informações, consulte [Gerenciando seu ciclo de vida de armazenamento](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-lifecycle.html) no *Guia do usuário do Amazon Simple Storage Service*.
**Para reverter VHD de configurações de aplicativo do usuário**
Você pode reverter para uma versão anterior das configurações de aplicativo do usuário VHD, excluindo as versões mais recentes do VHD aplicáveis a partir do bucket do S3. Não faça isso quando o usuário tiver uma sessão de streaming ativa.
1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Na lista **Nome do bucket**, escolha o bucket do S3 que contém as configurações de aplicativo do usuário das versões de VHD para a qual deseja reverter.
1. Localize e selecione a pasta que contém o VHD. Para obter mais informações sobre como navegar na estrutura de pastas do bucket do S3, consulte *Armazenamento do bucket da Amazon S3* anteriormente neste tópico.
Quando você seleciona a pasta, as configurações de de arquivo VHD e metadados associados são exibidos.
1. Para exibir uma lista de versões de arquivo VHD e metadados, escolhe **Exibir**.
1. Localize a versão do VHD para revertê-la.
1. Na lista **Nome**, marque as caixas de seleção próximas às versões mais recentes dos arquivos associados de VHD e metadados, escolha **Mais**, e depois escolha **Excluir**.
1. Verifique se as configurações da aplicativo VHD que você deseja reverter e o arquivo de metadados associado estão nas versões mais recentes destes arquivos.
A próxima vez que o usuário transmitir a partir de um pool no qual a persistência de configurações de aplicativo está ativada com o pool de configurações aplicável, a versão revertida das configurações do usuário é exibida.
## Aumentar o tamanho das configurações de aplicativo VHD
O tamanho máximo de VHD padrão é 5 GB para Pools. Se um usuário precisar de espaço adicional para configurações da aplicativo, você pode baixar as configurações do aplicativo VHD aplicável para um computador Windows para expandi-lo. Em seguida, substitua o VHD atual no bucket do S3 pelo maior. Não faça isso quando o usuário tiver uma sessão de streaming ativa.
**nota**
Para reduzir o tamanho físico do disco rígido virtual (VHD), limpe a lixeira antes de encerrar uma sessão. Isso também reduz os tempos de upload e download e melhora a experiência geral do usuário.
**Para aumentar o tamanho das configurações da aplicativo VHD**
**nota**
O VHD completo deve ser baixado antes que um usuário possa transmitir aplicativos. Aumentar o tamanho das configurações de aplicativo VHD pode aumentar o tempo que leva para os usuários iniciarem as sessões de streaming da aplicativo.
1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Na lista **Nome do bucket**, escolha o nome do bucket S3 que contém as configurações de aplicativo da VHD a serem expandidas.
1. Localize e selecione a pasta que contém o VHD. Para obter mais informações sobre como navegar na estrutura de pastas do bucket do S3, consulte [Armazenamento em bucket do Amazon S3](#app-persistence-s3-buckets) anteriormente neste tópico.
Quando você seleciona a pasta, as configurações de de arquivo VHD e metadados associados são exibidos.
1. Faça download do arquivo `Profile.vhdx` para um diretório no computador com Windows. Não feche o navegador depois que o download for concluído, porque você vai usar o navegador novamente mais tarde para carregar o VHD expandido.
1. Para usar o Diskpart para aumentar o tamanho do VHD para 7 GB, abra o prompt de comando como administrador e digite os seguintes comandos.
```
diskpart
```
```
select vdisk file="C:\path\to\application\settings\profile.vhdx"
```
```
expand vdisk maximum=7000
```
1. Em seguida, digite os seguintes comandos Diskpart para localizar e anexar o VHD e exibir a lista de volumes:
```
elect vdisk file="C:\path\to\application\settings\profile.vhdx"
```
```
attach vdisk
```
```
list volume
```
Na saída, anote o número do volume com a etiqueta "AwsEucUsers”. Na próxima etapa, selecione esse volume para que você possa ampliá-lo.
1. Digite o comando a seguir, em que `` é o número na saída do volume da lista.
```
select volume
```
1. Digite o seguinte comando:
```
extend
```
1. Digite os comandos a seguir para confirmar se o tamanho da partição no VHD foi aumentado como esperado (7 GB, neste exemplo):
```
diskpart
```
```
select vdisk file="C:\path\to\application\settings\profile.vhdx"
```
```
list volume
```
1. Digite o comando a seguir para desanexar o VHD para que ele possa ser carregado:
```
detach vdisk
```
1. Volte ao navegador com o console do Amazon S3, escolha **Carregar** e **Adicionar arquivos**, depois selecione o VHD aumentado.
1. Escolha **Carregar**.
Depois do VHD ser carregado, a próxima vez que o usuário transmitir a partir de um pool em que a persistência de configurações de aplicativo está ativada com o pool de configurações aplicável, são disponibilizadas as configurações maiores de aplicativos de VHD.