

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# WorkSpaces Personal에서 Windows BYOL WorkSpaces 업그레이드
<a name="upgrade-windows-10-byol-workspaces"></a>

Windows Bring Your Own License(BYOL) WorkSpaces에서 인플레이스 업그레이드 프로세스를 사용하여 최신 버전의 Windows로 업그레이드할 수 있습니다. 업그레이드하려면 이 항목의 지침을 따르세요.

인플레이스 업그레이드 프로세스는 Windows 10 및 11 BYOL WorkSpaces에만 적용됩니다.

**중요**  
업그레이드된 WorkSpace에서 Sysprep을 실행하지 마세요. 이렇게 하면 Sysprep 완료를 방해하는 오류가 발생할 수 있습니다. Sysprep을 실행하려면 업그레이드된 WorkSpace에서만 작업하세요.

**참고**  
이 프로세스를 사용하여 Windows 10 및 11 WorkSpaces를 최신 버전으로 업그레이드할 수 있습니다. 그러나 이 프로세스를 사용하여 Windows 10 WorkSpaces를 Windows 11로 업그레이드할 수는 없습니다.

**Topics**
+ [사전 조건](#upgrade_byol_prerequisites)
+ [고려 사항](#upgrade_byol_important_considerations)
+ [알려진 제한 사항](#byol-known-limitations)
+ [레지스트리 키 설정 요약](#upgrade_byol_registry_summary)
+ [현재 위치 업그레이드 수행](#upgrade_byol_procedure)
+ [문제 해결](#byol-troubleshooting)
+ [PowerShell 스크립트를 사용하여 WorkSpace 레지스트리 업데이트](#update-windows-10-byol-script)

## 사전 조건
<a name="upgrade_byol_prerequisites"></a>
+ 그룹 정책 또는 SCCM(System Center Configuration Manager)을 사용하여 Windows 10 및 11 업그레이드를 지연하거나 일시 중지한 경우, Windows 10 및 11 WorkSpace에 대한 운영 체제 업그레이드를 활성화합니다.
+ WorkSpace가 AutoStop WorkSpace인 경우 인플레이스 업그레이드 프로세스를 시작하기 전에 AlwaysOn WorkSpace로 변경해야 업데이트 적용 중에 자동 중지되지 않습니다. 자세한 내용은 [실행 모드 수정](running-mode.md#modify-running-mode) 섹션을 참조하세요. WorkSpace를 AutoStop 설정으로 그대로 두려면 업그레이드 수행 중 AutoStop 시간을 3시간 이상으로 변경하세요.
+ 인플레이스 업그레이드 프로세스는 기본 사용자(`C:\Users\Default`)라는 특수 프로필의 사본을 복사하여 사용자 프로필을 다시 생성합니다. 사용자 지정을 수행하는 데 이 기본 사용자 프로필을 사용하지 마세요. 그룹 정책 객체(GPO)를 통해 사용자 프로필을 사용자 지정하는 것이 좋습니다. GPO를 통한 사용자 지정은 쉽게 수정하거나 롤백할 수 있으며 오류가 발생할 가능성이 낮습니다.
+ 인플레이스 업그레이드 프로세스는 사용자 프로필을 하나만 백업하고 다시 만들 수 있습니다. D 드라이브에 사용자 프로필이 여러 개 있는 경우 필요한 프로필을 제외한 모든 프로필을 삭제하세요.

## 고려 사항
<a name="upgrade_byol_important_considerations"></a>

인플레이스 업그레이드 프로세스는 두 개의 레지스트리 스크립트(`enable-inplace-upgrade.ps1` 및 `update-pvdrivers.ps1`)를 사용하여 WorkSpaces에서 Windows Update 프로세스를 실행할 수 있도록 필요한 변경을 수행합니다. 이러한 변경에는 D 드라이브 대신에 C 드라이브에 (임시) 사용자 프로필을 생성하는 작업이 포함됩니다. 사용자 프로필이 이미 D 드라이브에 있는 경우 원래 사용자 프로필의 데이터는 D 드라이브에 남아있게 됩니다.

기본적으로 WorkSpaces는 사용자 프로필을 `D:\Users\%USERNAME%`에 생성합니다. `enable-inplace-upgrade.ps1` 스크립트는 새 사용자 프로필을 `C:\Users\%USERNAME%`에 생성하도록 Windows를 구성하고 사용자 셸 폴더를 `D:\Users\%USERNAME%`으로 리디렉션합니다. 이 새 사용자 프로필은 사용자가 처음 로그온할 때 생성됩니다.

인플레이스 업그레이드 후, 사용자가 나중에 Windows Update 프로세스를 사용하여 시스템을 업그레이드할 수 있도록 사용자 프로필을 C 드라이브에 그대로 둘 수도 있습니다. 하지만 C 드라이브에 저장된 프로필이 있는 WorkSpaces는 사용자 프로필에 있는 모든 데이터를 직접 백업하고 복원하지 않을 경우 해당 데이터 손실 없이 다시 빌드하거나 마이그레이션할 수 없습니다. 프로필을 C 드라이브에 그대로 두려는 경우 이 주제의 뒷부분에서 설명한 대로 **UserShellFoldersRedirection** 레지스트리 키를 사용하여 사용자 셸 폴더를 D 드라이브로 리디렉션할 수 있습니다.

WorkSpaces를 다시 빌드하거나 마이그레이션할 수 있고 사용자 셸 폴더 리디렉션과 관련해 발생할 수도 있는 문제를 방지하려면, 인플레이스 업그레이드 후에 사용자 프로필을 D 드라이브로 복원하도록 선택하는 것이 좋습니다. 이 주제의 뒷부분에서 설명한 대로 **PostUpgradeRestoreProfileOnD** 레지스트리 키를 사용하여 이 작업을 수행할 수 있습니다.

## 알려진 제한 사항
<a name="byol-known-limitations"></a>
+ WorkSpace를 다시 빌드하거나 마이그레이션할 때 D 드라이브에서 C 드라이브로 사용자 프로필 위치가 변경되지 않습니다. Windows 10 또는 11 BYOL WorkSpace에서 인플레이스 업그레이드를 수행한 후 다시 빌드하거나 마이그레이션하는 경우, 새 WorkSpace는 D 드라이브에 사용자 프로필을 갖게 됩니다.
**주의**  
인플레이스 업그레이드 후에 사용자 프로필을 C 드라이브에 그대로 두는 경우, 다시 빌드하거나 마이그레이션하기 전에 사용자 프로필 데이터를 수동으로 백업하고 프로세스를 다시 빌드하거나 마이그레이션한 후 사용자 프로필 데이터를 수동으로 복원하지 않으면 다시 빌드하거나 마이그레이션하는 중에 C 드라이브에 저장된 사용자 프로필 데이터가 손실됩니다.
+ 기본 BYOL 번들에 이전 버전의 Windows 10 및 11 기반의 이미지가 있는 경우, WorkSpace를 다시 빌드하거나 마이그레이션한 후 인플레이스 업그레이드를 다시 수행해야 합니다.

## 레지스트리 키 설정 요약
<a name="upgrade_byol_registry_summary"></a>

인플레이스 업그레이드 프로세스를 활성화하고 업그레이드 후 사용자 프로필을 배치할 위치를 지정하려면 여러 레지스트리 키를 설정해야 합니다.


**레지스트리 경로: **HKLM:\$1Software\$1Amazon\$1WorkSpacesConfig\$1enable-inplace-upgrade.ps1****  

| 레지스트리 키 | Type | 값 | 
| --- | --- | --- | 
| 활성화됨 | DWORD |  **0** - (기본값) 인플레이스 업그레이드를 비활성화합니다. **1** - 인플레이스 업그레이드를 활성화합니다.  | 
| PostUpgradeRestoreProfileOnD | DWORD |  **0** - (기본값) 인플레이스 업그레이드 후 사용자 프로필 경로 복원을 시도하지 않습니다. **1** - 인플레이스 업그레이드 후 사용자 프로필 경로(**ProfileImagePath**)를 복원합니다.  | 
| UserShellFoldersRedirection | DWORD |  **0** - 사용자 쉘 폴더의 리디렉션을 활성화하지 않습니다. **1** - (기본값) 사용자 프로필이 `C:\Users\%USERNAME%`에 다시 생성된 후 `D:\Users\%USERNAME%`으로의 사용자 쉘 폴더 리디렉션을 활성화합니다.  | 
| NoReboot | DWORD |  **0** - (기본값) 사용자 프로필에 대한 레지스트리를 수정한 후 재부팅하는 시간을 제어할 수 있습니다. **1** - 사용자 프로필에 대한 레지스트리를 수정한 후 스크립트가 WorkSpace를 재부팅하도록 허용하지 않습니다.  | 


**레지스트리 경로: **HKLM:\$1Software\$1Amazon\$1WorkSpacesConfig\$1update-pvdrivers.ps1****  

| 레지스트리 키 | Type | 값 | 
| --- | --- | --- | 
| 활성화됨 | DWORD |  **0** - (기본값) AWS PV 드라이버 업데이트를 비활성화합니다. **1** - AWS PV 드라이버 업데이트 활성화  | 

## 현재 위치 업그레이드 수행
<a name="upgrade_byol_procedure"></a>

BYOL WorkSpaces에서 인플레이스 Windows 업그레이드를 활성화하려면 다음 절차에 설명한 대로 특정 레지스트리 키를 설정해야 합니다. 인플레이스 업그레이드를 완료한 후 사용자 프로필이 위치할 드라이브(C 또는 D)를 가리키는 데에도 특정 레지스트리 키를 설정해야 합니다.

이러한 레지스트리를 수동으로 변경할 수 있습니다. 업데이트할 WorkSpace가 여러 개인 경우 그룹 정책이나 SCCM을 사용하여 PowerShell 스크립트를 푸시합니다. 샘플 PowerShell 스크립트는 [PowerShell 스크립트를 사용하여 WorkSpace 레지스트리 업데이트](#update-windows-10-byol-script) 섹션을 참조하세요.

**Windows 10 및 11의 인플레이스 업그레이드를 수행하려면**

1. 업데이트하려는 Windows 10 및 11 BYOL WorkSpaces에서 현재 실행 중인 Windows의 버전을 기록한 후 재부팅합니다.

1. 다음 Windows 시스템 레지스트리 키를 업데이트하여 **활성** 값 데이터를 **0**에서 **1**로 변경합니다. 다음 레지스트리 변경은 WorkSpace의 인플레이스 업그레이드를 활성화합니다.
   + **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1WorkSpacesConfig\$1enable-inplace-upgrade.ps1**
   + **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1WorkSpacesConfig\$1update-pvdrivers.ps1**
**참고**  
이러한 키가 없으면 WorkSpace를 재부팅합니다. 시스템을 재부팅할 때 이러한 키가 추가되어야 합니다.

   (선택 사항) SCCM Task Sequences 같은 관리형 워크플로를 사용하여 업그레이드를 수행하는 경우, 다음 키 값을 **1**로 설정하여 컴퓨터 재부팅을 방지합니다.

   **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1WorkSpacesConfig\$1enable-inplace-upgrade.ps1\$1NoReboot**

1. 인플레이스 업그레이드 프로세스(자세한 내용은 [고려 사항](#upgrade_byol_important_considerations) 섹션 참조) 후에 사용자 프로필이 위치할 드라이브를 결정하고 다음과 같이 레지스트리 키를 설정합니다.
   + 업그레이드 후 사용자 프로필을 C 드라이브에 위치시키려는 경우 설정:

     **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1WorkSpacesConfig\$1enable-inplace-upgrade.ps1**

     키 이름: **PostUpgradeRestoreProfileOnD**

     키 값: **0**

     키 이름: **UserShellFoldersRedirection**

     키 값: **1**
   + 업그레이드 후 사용자 프로필을 D 드라이브에 위치시키려는 경우 설정:

     **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1WorkSpacesConfig\$1enable-inplace-upgrade.ps1**

     키 이름: **PostUpgradeRestoreProfileOnD**

     키 값: **1**

     키 이름: **UserShellFoldersRedirection**

     키 값: **0**

1. 레지스트리에 대한 변경을 저장한 후 WorkSpace를 다시 재부팅해야 변경 사항이 적용됩니다.
**참고**  
재부팅 후 WorkSpace에 로그인하면 새로운 사용자 프로필이 생성됩니다. **시작** 메뉴에서 자리 표시자 아이콘을 볼 수 있습니다. 이 동작은 인플레이스 업그레이드가 완료되면 자동으로 해결됩니다.
WorkSpaces의 차단이 해제되도록 10분 정도 기다려 주세요.

   (선택 사항) 다음 키 값이 **1**로 설정되었는지 확인합니다. 이 값이 1로 설정되면 WorkSpace 업데이트가 차단되지 않습니다.

   **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1WorkSpacesConfig\$1enable-inplace-upgrade.ps1\$1profileImagePathDeleted**

1. 인플레이스 업그레이드를 수행합니다. SCCM, ISO, Windows 업데이트(WU) 등과 같은 원하는 방법을 사용할 수 있습니다. 이 프로세스는 원래 Windows 10 및 11 버전과 설치된 앱 수에 따라 40\$1120분 정도 걸릴 수 있습니다.
**참고**  
인플레이스 업그레이드 프로세스에는 최소 한 시간이 걸릴 수 있습니다. WorkSpaces 인스턴스 상태는 업그레이드 중에 `UNHEALTHY`로 표시될 수 있습니다.

1. 업데이트 프로세스가 완료되면 Windows 버전이 업데이트되었는지 확인합니다.
**참고**  
인플레이스 업그레이드가 실패하면 Windows는 자동으로 롤백하여 업그레이드를 시작하기 전에 있던 Windows 10 및 11 버전을 사용합니다. 문제 해결에 대한 자세한 내용은 [Microsoft 설명서](https://docs.microsoft.com/en-us/windows/deployment/upgrade/resolve-windows-10-upgrade-errors)를 참조하세요.

   (선택 사항) 업데이트 스크립트가 성공적으로 실행되었는지 확인하려면 다음 키 값이 **1**로 설정되었는지 확인합니다.

   **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1WorkSpacesConfig\$1enable-inplace-upgrade.ps1\$1scriptExecutionComplete**

1. 인플레이스 업그레이드 프로세스가 중단 없이 실행될 수 있도록 AlwaysOn으로 설정하거나 AutoStop 기간을 변경하여 WorkSpace의 실행 모드를 수정한 경우, 실행 모드를 원래 설정으로 다시 설정합니다. 자세한 내용은 [실행 모드 수정](running-mode.md#modify-running-mode) 섹션을 참조하세요.

**PostUpgradeRestoreProfileOnD** 레지스트리 키를 **1**로 설정하지 않은 경우, 사용자 프로필은 Windows에서 다시 만들어지고 인플레이스 업그레이드 후에 `C:\Users\%USERNAME%`에 배치되므로 추후 Windows 10 및 11 인플레이스 업그레이드 시 위의 단계를 다시 수행할 필요가 없습니다. 기본적으로 `enable-inplace-upgrade.ps1` 스크립트는 다음 셸 폴더를 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`

셸 폴더를 WorkSpace의 다른 위치로 재지정한 경우 인플레이스 업그레이드 후에 WorkSpace에서 필요한 작업을 수행하세요.

## 문제 해결
<a name="byol-troubleshooting"></a>

업데이트와 관련된 문제가 발생하는 경우, 다음 항목을 확인하면 문제를 해결하는 데 도움이 될 수 있습니다.
+ Windows 로그(기본적으로 다음 위치에 있음):

  `C:\Program Files\Amazon\WorkSpacesConfig\Logs\`

  `C:\Program Files\Amazon\WorkSpacesConfig\Logs\TRANSMITTED`
+ Windows 이벤트 뷰어

  Windows 로그 > 응용 프로그램 > 소스: Amazon WorkSpaces

**작은 정보**  
인플레이스 업그레이드 프로세스 중에 바탕 화면의 바로 가기 아이콘 일부가 작동하지 않는 경우 WorkSpace가 업그레이드를 위해 D 드라이브에 있는 사용자 프로필을 C 드라이브로 옮겼기 때문입니다. 업그레이드가 완료되면 바로 가기가 작동합니다.

### ISO 오류 해결을 사용한 Windows 11 24H2 업그레이드
<a name="upgrade-iso-resolution"></a>

Windows 11 24H2 업그레이드 프로세스에서 두 번째 부팅 단계 중에 특히 오류 코드 0xC1900101\$10x40017을 나타내는 심각한 부팅 오류가 발생할 수 있습니다. 이 오류는 일반적으로 시스템 드라이버 파일이 누락되거나 손상되어 부팅 작업 단계에서 설치가 성공적으로 완료되지 않기 때문에 발생합니다.

*오류 코드:* 0xC1900101 - 0x40017

*오류 설명:* SECOND\$1BOOT 단계에서 BOOT 작업 오류가 발생한 설치 실패

1. Windows 11 24H2 ISO 파일이 있는지 확인합니다.

1. 관리자 권한으로 명령 프롬프트를 엽니다.

1. 다음 명령을 사용하여 필요한 시스템 파일을 복사합니다.

   ```
   copy "ISO-Drive:\Sources\WinSetupMon.sys" "C:\Windows\System32\Drivers\"
   ```

   **ISO-Drive**를 ISO 드라이브 정보로 바꿉니다.

1. 다음을 사용하여 파일 복사본을 확인합니다.

   ```
   C:\Windows\System32\Drivers\
   ```

1. ISO 파일을 사용하여 Windows 11 24H2 업그레이드를 시작합니다.

## PowerShell 스크립트를 사용하여 WorkSpace 레지스트리 업데이트
<a name="update-windows-10-byol-script"></a>

다음 샘플 PowerShell 스크립트를 사용하여 WorkSpace의 레지스트리를 업데이트하고 인플레이스 업그레이드를 활성화할 수 있습니다. [현재 위치 업그레이드 수행](#upgrade_byol_procedure)를 따릅니다. 단, 이 스크립트는 각 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
    }
}
```