As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Administre 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.