Atualize o Windows BYOL WorkSpaces em WorkSpaces Personal

Em seu Windows Bring Your Own License (BYOL) WorkSpaces, você pode 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 in-loco se aplica somente ao WorkSpaces BYOL do Windows 10 e 11.

Importante

Não execute o Sysprep em um upgrade. WorkSpace Se você fizer isso, poderá ocorrer um erro que impede a conclusão do Sysprep. Se você planeja executar o Sysprep, faça isso somente em um WorkSpace que não tenha sido atualizado.

nota

Você pode usar esse processo para atualizar o Windows 10 e 11 WorkSpaces para uma versão mais recente. No entanto, esse processo não pode ser usado para atualizar seu Windows 10 WorkSpaces para o Windows 11.

Pré-requisitos

• Se você adiou ou pausou as atualizações do Windows 10 e 11 usando a Política de Grupo ou o System Center Configuration Manager (SCCM), habilite as atualizações do sistema operacional para o Windows 10 e 11. WorkSpaces

• Se WorkSpace for um AutoStop WorkSpace, altere-o para um AlwaysOn WorkSpace antes do processo de atualização local para que ele não pare automaticamente enquanto as atualizações estiverem sendo aplicadas. Para ter mais informações, consulte Modificar o modo de execução. Se você preferir manter a WorkSpace configuração AutoStop, altere o AutoStop tempo para três horas ou mais enquanto a atualização ocorre.

• 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 no local usa dois scripts de registro (enable-inplace-upgrade.ps1eupdate-pvdrivers.ps1) para fazer as alterações necessárias no seu WorkSpaces que permitem a execução do processo do Windows Update. 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, WorkSpaces cria o perfil do usuário emD:\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, lembre-se de que, WorkSpaces com os perfis armazenados na unidade C, não é possível recriar ou migrar sem perder todos os dados no perfil do usuário, a menos que você mesmo faça backup e restaure esses dados. Se você decidir deixar os perfis na unidade C, poderá usar a chave do UserShellFoldersRedirectionregistro para redirecionar as pastas do shell do usuário para a unidade D, conforme explicado posteriormente neste tópico.

Para garantir que você possa reconstruir ou migrar sua pasta WorkSpaces e evitar possíveis problemas com o redirecionamento da pasta shell do usuário, recomendamos que você opte por restaurar seus perfis de usuário na unidade D após a atualização local. Você pode fazer isso usando a chave de registro PostUpgradeRestoreProfileOnD, conforme explicado posteriormente 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 acontece durante WorkSpace reconstruções ou migrações. Se você realizar uma atualização in-loco em um BYOL do Windows 10 ou 11 WorkSpace 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.

• Se o pacote BYOL padrão contiver uma imagem baseada em uma versão anterior do Windows 10 e 11, você deverá realizar a atualização in-loco novamente após a reconstrução ou WorkSpace migração.

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.

Caminho de registro: HKL M:\Software\Amazon\WorkSpacesConfig\ .ps1 enable-inplace-upgrade
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 D:\Users\%USERNAME% depois que o perfil do usuário é gerado novamente em C:\Users\%USERNAME%
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 reinicie o WorkSpace depois de modificar o registro do perfil do usuário

Caminho de registro: HKL M:\Software\Amazon\WorkSpacesConfig\ update-pvdrivers.ps1
Chave do registro	Tipo	Valores
Ativado	DWORD	0 — (Padrão) Desativa a atualização de drivers AWS fotovoltaicos 1 — Permite a atualização de drivers AWS fotovoltaicos

Realizar uma atualização no local

Para habilitar atualizações in-loco do Windows em seu BYOL WorkSpaces, você deve definir determinadas chaves de 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 PowerShell script. Para obter um exemplo de PowerShell script, consulteAtualize seu WorkSpace registro usando um PowerShell script.

Para realizar uma atualização local do Windows 10 e 11

1. Anote qual versão do Windows está sendo executada atualmente no BYOL do Windows 10 e 11 WorkSpaces que você está atualizando e, em seguida, reinicie-as.

2. 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\\ .ps1 WorkSpacesConfig enable-inplace-upgrade

   • HKEY_LOCAL_MACHINE\ SOFTWARE\ Amazon\\ update-pvdrivers.ps1 WorkSpacesConfig

   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\\ .ps1\ WorkSpacesConfig enable-inplace-upgrade NoReboot

3. 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\\ .ps1 WorkSpacesConfig enable-inplace-upgrade

     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\\ .ps1 WorkSpacesConfig enable-inplace-upgrade

     Nome da chave: PostUpgradeRestoreProfileOnD

     Valor da chave: 1

     Nome da chave: UserShellFoldersRedirection

     Valor da chave: 0

4. Depois de salvar as alterações no registro, reinicie WorkSpace novamente para que as alterações sejam aplicadas.

   nota

   • Após a reinicialização, o login no WorkSpace cria um novo perfil de usuário. É 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 ele WorkSpace esteja desbloqueado.

   (Opcional) Confirme se o valor da chave a seguir está definido como 1, o que desbloqueia o WorkSpace para atualização:

   HKEY_LOCAL_MACHINE\ SOFTWARE\ Amazon\\ .ps1\ Excluído WorkSpacesConfig enable-inplace-upgrade profileImagePath

5. 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 11 e de quantos aplicativos foram instalados, esse processo pode levar de 40 a 120 minutos.

   nota

   O processo de atualização in-loco pode levar pelo menos uma hora. O status da WorkSpace instância pode aparecer como UNHEALTHY durante a atualização.

6. Depois que o processo de atualização for concluído, confirme se a versão do Windows foi atualizada.

   nota

   Se a atualização in-loco falhar, o Windows reverte automaticamente para usar a versão do Windows 10 e 11 que estava em vigor antes de você iniciar a 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\\ .ps1\ WorkSpacesConfig enable-inplace-upgrade scriptExecutionComplete

7. Se você modificou o modo de execução do WorkSpace definindo-o AlwaysOn ou alterando o período de AutoStop tempo para que o processo de atualização no local pudesse ser executado sem interrupção, redefina o modo de execução para as configurações originais. Para ter mais informações, consulte Modificar o modo de execução.

Se você não tiver definido a chave de registro PostUpgradeRestoreProfileOnD como 1, o perfil do usuário será regenerado pelo Windows e inserido C:\Users\%USERNAME% após a atualização local, para que você não precise seguir as etapas acima novamente para futuras atualizações in-loco 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 sua WorkSpaces, execute as operações necessárias WorkSpaces após as atualizações no local.

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

Durante o processo de atualização no local, se você perceber que alguns atalhos de ícones na área de trabalho não funcionam mais, é porque WorkSpaces move qualquer perfil de usuário localizado na unidade D para a unidade C para se preparar para a atualização. Depois de concluída a atualização, os atalhos funcionarão conforme o esperado.

Atualize seu WorkSpace registro usando um PowerShell script

Você pode usar o seguinte exemplo de PowerShell script para atualizar o registro no seu e WorkSpaces habilitar atualizações no local. Siga aRealizar uma atualização no local, mas use esse script para atualizar o registro em cada um 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
    }
}