Atualizar WorkSpaces BYOL do Windows no WorkSpaces Personal
Nos WorkSpaces Windows traga a sua própria licença (BYOL), é possível atualizar para uma versão mais recente do Windows usando o processo de atualização no local. Siga as instruções neste tópico para fazer a atualização.
O processo de atualização no local se aplica apenas aos WorkSpaces BYOL do Windows 10.
Importante
Não execute o Sysprep em um WorkSpace atualizado. Se você fizer isso, poderá ocorrer um erro que impede a conclusão do Sysprep. Se você planeja executar o Sysprep, faça isso apenas em um WorkSpace que não foi atualizado.
nota
Você pode usar esse processo para atualizar o Windows 10 WorkSpaces para uma versão mais recente. No entanto, esse processo não pode ser usado para atualizar os Windows 10 WorkSpaces para Windows 11.
Conteúdos
Pré-requisitos
-
Se você tiver adiado ou pausado as atualizações do Windows 10 usando políticas de grupo ou o System Center Configuration Manager (SCCM), habilite as atualizações do sistema operacional para os WorkSpaces do Windows 10.
-
Se o WorkSpace for um WorkSpace no modo AutoStop, altere-o para um WorkSpace no modo AlwaysOn antes do processo de atualização local para que ele não seja interrompido automaticamente enquanto as atualizações são aplicadas. Para ter mais informações, consulte Modificar o modo de execução. Se você preferir manter o WorkSpace definido como AutoStop, altere o tempo de AutoStop para três horas ou mais durante a atualização.
-
O processo de atualização local recria o perfil do usuário fazendo uma cópia de um perfil especial chamado Default User (
C:\Users\Default
). Não use esse perfil de usuário padrão para fazer personalizações. Recomendamos fazer personalizações no perfil do usuário por meio de GPOs (Objetos de política de grupo). As personalizações feitas por meio de GPOs podem ser facilmente modificadas ou revertidas e são menos propensas a erros. -
O processo de atualização no local pode fazer backup e recriar somente um perfil de usuário. Se você tiver vários perfis de usuário na unidade D, exclua todos os perfis, exceto aquele que você precisa.
Considerações
O processo de atualização in-loco usa dois scripts de registro (enable-inplace-upgrade.ps1
e update-pvdrivers.ps1
) para fazer as alterações necessárias nos WorkSpaces que permitem que o processo do Windows Update seja executado. Essas alterações envolvem a criação de um perfil de usuário (temporário) na unidade C em vez de na unidade D. Se já existir um perfil de usuário na unidade D, os dados nesse perfil original permanecerão na unidade D.
Por padrão, os WorkSpaces criam o perfil de usuário no D:\Users\%USERNAME%
. O script enable-inplace-upgrade.ps1
configura o Windows para criar um perfil de usuário em C:\Users\%USERNAME%
e redireciona as pastas do shell do usuário para D:\Users\%USERNAME%
. Esse perfil de usuário é criado quando um usuário faz login pela primeira vez.
Após a atualização in-loco, você tem a opção de deixar seus perfis de usuário na unidade C para permitir que seus usuários utilizem o processo do Windows Update para atualizar seus computadores no futuro. No entanto, esteja ciente de que os WorkSpaces com perfis armazenados na unidade C não podem ser reconstruídos nem migrados sem que ocorra a perda de todos os dados no perfil do usuário, a menos que você faça backup e restaure esses dados por conta própria. Se você decidir deixar os perfis na unidade C, poderá usar a chave de registro UserShellFoldersRedirection para redirecionar as pastas do shell do usuário para a unidade D, conforme explicado mais adiante neste tópico.
Para garantir que você possa recriar ou migrar seus WorkSpaces e evitar possíveis problemas com o redirecionamento da pasta do shell do usuário, recomendamos que você opte por restaurar seus perfis de usuário para a unidade D após a atualização in-loco. É possível fazer isso usando a chave de registro PostUpgradeRestoreProfileOnD conforme explicado mais adiante neste tópico.
Limitações conhecidas
-
A alteração da localização do perfil do usuário da unidade D para a unidade C não ocorre durante as reconstruções ou migrações do WorkSpace. Se você executar uma atualização in-loco em um WorkSpace BYOL do Windows 10 e, depois, reconstruí-lo ou migrá-lo, o novo WorkSpace terá o perfil de usuário na unidade D.
Atenção
Se você deixar o perfil de usuário na unidade C após a atualização in-loco, os dados do perfil armazenados na unidade C serão perdidos durante reconstruções ou migrações, a menos que você faça backup manualmente dos dados do perfil de usuário antes de recriar ou migrar e, depois, restaure manualmente os dados do perfil após executar o processo de recriação ou migração.
-
Além disso, se o seu pacote BYOL contiver a imagem baseada em uma versão anterior do Windows 10, será necessário executar a atualização in-loco novamente depois de recriar ou migrar o WorkSpace.
Resumo das configurações da chave do registro
Para habilitar o processo de atualização in-loco e especificar o local do perfil de usuário após a atualização, é necessário definir uma série de chaves do registro.
Chave do registro | Tipo | Valores |
---|---|---|
Ativado | DWORD |
0: (padrão) desativa a atualização in-loco 1: permite a atualização in-loco |
PostUpgradeRestoreProfileOnD | DWORD |
0: (padrão) não tenta restaurar o caminho do perfil do usuário após a atualização in-loco 1: restaura o caminho do perfil do usuário (ProfileImagePath) após a atualização in-loco |
UserShellFoldersRedirection | DWORD |
0: não habilita o redirecionamento de pastas do shell do usuário 1: (padrão) habilita o redirecionamento de pastas do shell do usuário para |
NoReboot | DWORD |
0: (padrão) permite controlar quando ocorre uma reinicialização após modificar o registro para o perfil de usuário 1: não permite que o script reinicialize o WorkSpace depois de modificar o registro para o perfil de usuário |
Chave do registro | Tipo | Valores |
---|---|---|
Ativado | DWORD |
0: (padrão) desativa a atualização de drivers do AWS PV 1: permite a atualização de drivers do AWS PV |
Realizar uma atualização no local
Para habilitar atualizações in-loco do Windows em seus WorkSpaces BYOL, é necessário definir determinadas chaves do registro, conforme descrito no procedimento a seguir. Também é preciso definir determinadas chaves do registo para indicar a unidade (C ou D) onde os perfis de usuário deverão estar depois de concluídas as atualizações in-loco.
É possível fazer essas alterações de registro manualmente. Se você tiver vários WorkSpaces para atualizar, poderá usar a política de grupo ou o SCCM para enviar um script do PowerShell. Para obter um exemplo de script do PowerShell, consulte Atualize o registro do WorkSpace usando um script do PowerShell.
Para executar uma atualização local do Windows 10
-
Anote a versão do Windows atualmente em execução nos WorkSpaces BYOL do Windows 10 que você está atualizando e, depois, reinicialize-os.
-
Atualize as seguintes chaves do registro do sistema Windows para alterar os dados de valor de Enabled (Habilitado) de 0 para 1. Essas alterações no registro permitem atualizações locais para o WorkSpace.
-
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\WorkSpacesConfig\enable-inplace-upgrade.ps1
-
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\WorkSpacesConfig\update-pvdrivers.ps1
nota
Se essas chaves não existirem, reinicie o WorkSpace. As chaves devem ser adicionadas quando o sistema for reiniciado.
(Opcional) Se você estiver usando um fluxo de trabalho gerenciado, como as sequências de tarefas do SCCM, para realizar a atualização, defina o seguinte valor de chave como 1 para impedir que o computador seja reinicializado:
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\WorkSpacesConfig\enable-inplace-upgrade.ps1\NoReboot
-
-
Decida em qual unidade os perfis de usuário deverão estar após o processo de atualização in-loco (para obter mais informações, consulte Considerações) e defina as chaves de registo da seguinte forma:
-
Configurações se o local do perfil de usuário precisar ser a unidade C após a atualização:
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\WorkSpacesConfig\enable-inplace-upgrade.ps1
Nome da chave: PostUpgradeRestoreProfileOnD
Valor da chave: 0
Nome da chave: UserShellFoldersRedirection
Valor da chave: 1
-
Configurações se o local do perfil de usuário precisar ser a unidade D após a atualização:
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\WorkSpacesConfig\enable-inplace-upgrade.ps1
Nome da chave: PostUpgradeRestoreProfileOnD
Valor da chave: 1
Nome da chave: UserShellFoldersRedirection
Valor da chave: 0
-
-
Depois de salvar as alterações no registro, reinicie o WorkSpace novamente para que as alterações sejam aplicadas.
nota
-
Após a reinicialização, ao fazer login no WorkSpace um novo perfil de usuário será criado. É possível ver os ícones de espaço reservado no menu Start (Iniciar). Esse comportamento é resolvido automaticamente após a conclusão da atualização no local.
-
Aguarde 10 minutos para garantir que o WorkSpace esteja desbloqueado.
(Opcional) Confirme que o valor da chave a seguir está configurado como 1. Isso desbloqueia o WorkSpace para atualizar:
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\WorkSpacesConfig\enable-inplace-upgrade.ps1\profileImagePathDeleted
-
-
Execute a atualização local. Você pode usar qualquer método que desejar, como SCCM, ISO ou Windows Update (WU). Dependendo da versão original do Windows 10 e de quantos aplicativos foram instalados, esse processo poderá levar entre 40 e 120 minutos.
nota
O processo de atualização in-loco pode levar pelo menos uma hora. O status da instância do WorkSpace pode aparecer como
UNHEALTHY
durante a atualização. -
Depois que o processo de atualização for concluído, confirme se a versão do Windows foi atualizada.
nota
Se a atualização local falhar, o Windows reverterá automaticamente para usar a versão do Windows 10 anterior à atualização. Para obter mais informações sobre a solução de problemas, consulte a documentação da Microsoft
. (Opcional) Para confirmar que os scripts de atualização foram executados com êxito, verifique se o seguinte valor da chave está configurado como 1:
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\WorkSpacesConfig\enable-inplace-upgrade.ps1\scriptExecutionComplete
-
Se você modificou o modo de execução do WorkSpace definindo-o como AlwaysOn ou alterando o tempo de AutoStop para que o processo de atualização in-loco possa ser executado sem interrupção, restaure as configurações originais do modo de execução. Para ter mais informações, consulte Modificar o modo de execução.
Se você não tiver definido a chave do registro PostUpgradeRestoreProfileOnD como 1, o perfil do usuário será gerado novamente pelo Windows e colocado em C:\Users\%USERNAME%
após a atualização no local, para que você não precise passar pelas etapas acima novamente para futuras atualizações no local do Windows 10 e 11. Por padrão, o script enable-inplace-upgrade.ps1
redireciona as seguintes pastas do shell para a unidade D:
-
D:\Users\%USERNAME%\Downloads
-
D:\Users\%USERNAME%\Desktop
-
D:\Users\%USERNAME%\Favorites
-
D:\Users\%USERNAME%\Music
-
D:\Users\%USERNAME%\Pictures
-
D:\Users\%USERNAME%\Videos
-
D:\Users\%USERNAME%\Documents
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\Network Shortcuts
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\Printer Shortcuts
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\Start Menu\Programs
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\Recent
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\SendTo
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\Start Menu
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
-
D:\Users\%USERNAME%\AppData\Roaming\Microsoft\Windows\Templates
Se você redirecionar as pastas do shell para outros locais em seu WorkSpaces, execute as operações necessárias nos WorkSpaces após as atualizações locais.
Solução de problemas
Se você tiver problemas com a atualização, verifique os seguintes itens para auxiliar na solução de problemas:
-
Logs do Windows, que, por padrão, estão localizados nos seguintes locais:
C:\Program Files\Amazon\WorkSpacesConfig\Logs\
C:\Program Files\Amazon\WorkSpacesConfig\Logs\TRANSMITTED
-
Visualizador de eventos do Windows
Logs do Windows > Aplicativo > Fonte: Amazon WorkSpaces
dica
Se, durante o processo, você vir que alguns atalhos de ícone na área de trabalho não funcionam mais, isso acontece porque o WorkSpaces move os perfis de usuário localizados na unidade D para a unidade C a fim de se preparar para a atualização. Depois de concluída a atualização, os atalhos funcionarão conforme o esperado.
Atualize o registro do WorkSpace usando um script do PowerShell
Você pode usar o seguinte exemplo de script do PowerShell para atualizar o registro no seu WorkSpaces para habilitar as atualizações locais. Siga o Realizar uma atualização no local, mas use este script para atualizar o registro em cada WorkSpace.
# AWS WorkSpaces 1.28.20 # Enable In-Place Update Sample Scripts # These registry keys and values will enable scripts to run on the next reboot of the WorkSpace. $scriptlist = ("update-pvdrivers.ps1","enable-inplace-upgrade.ps1") $wsConfigRegistryRoot="HKLM:\Software\Amazon\WorkSpacesConfig" $Enabled = 1 $script:ErrorActionPreference = "Stop" foreach ($scriptName in $scriptlist) { $scriptRegKey = "$wsConfigRegistryRoot\$scriptName" try { if (-not(Test-Path $scriptRegKey)) { Write-Host "Registry key not found. Creating registry key '$scriptRegKey' with 'Update' enabled." New-Item -Path $wsConfigRegistryRoot -Name $scriptName | Out-Null New-ItemProperty -Path $scriptRegKey -Name Enabled -PropertyType DWord -Value $Enabled | Out-Null Write-Host "Value created. '$scriptRegKey' Enabled='$((Get-ItemProperty -Path $scriptRegKey).Enabled)'" } else { Write-Host "Registry key is already present with value '$scriptRegKey' Enabled='$((Get-ItemProperty -Path $scriptRegKey).Enabled)'" if((Get-ItemProperty -Path $scriptRegKey).Enabled -ne $Enabled) { Set-ItemProperty -Path $scriptRegKey -Name Enabled -Value $Enabled Write-Host "Value updated. '$scriptRegKey' Enabled='$((Get-ItemProperty -Path $scriptRegKey).Enabled)'" } } } catch { write-host "Stopping script, the following error was encountered:" `r`n$_ -ForegroundColor Red break } }