

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Aktualisieren Sie Windows BYOL WorkSpaces in Personal WorkSpaces
<a name="upgrade-windows-10-byol-workspaces"></a>

Mit Ihrer Windows Bring Your Own License (BYOL) WorkSpaces können Sie mithilfe des direkten Aktualisierungsprozesses ein Upgrade auf eine neuere Version von Windows durchführen. Folgen Sie dazu den Anweisungen in diesem Thema.

Der direkte Upgradevorgang gilt nur für Windows 10 und 11 BYOL. WorkSpaces

**Wichtig**  
Führen Sie Sysprep nicht auf einem aktualisierten Gerät aus. WorkSpace Andernfalls kann ein Fehler auftreten, der verhindert, dass Sysprep abgeschlossen wird. Wenn Sie Sysprep ausführen möchten, tun Sie dies nur auf einem Computer, der noch nicht WorkSpace aktualisiert wurde.

**Anmerkung**  
Sie können diesen Vorgang verwenden, um Windows 10 und 11 auf eine neuere Version WorkSpaces zu aktualisieren. Dieser Vorgang kann jedoch nicht verwendet werden, um Windows 10 auf Windows 11 WorkSpaces zu aktualisieren.

**Topics**
+ [Voraussetzungen](#upgrade_byol_prerequisites)
+ [Überlegungen](#upgrade_byol_important_considerations)
+ [Bekannte Beschränkungen](#byol-known-limitations)
+ [Zusammenfassung der Registrierungsschlüsseleinstellungen](#upgrade_byol_registry_summary)
+ [Durchführen eines direkten Upgrades](#upgrade_byol_procedure)
+ [Fehlerbehebung](#byol-troubleshooting)
+ [Aktualisieren Sie Ihre WorkSpace Registrierung mithilfe eines Skripts PowerShell](#update-windows-10-byol-script)

## Voraussetzungen
<a name="upgrade_byol_prerequisites"></a>
+ Wenn Sie Windows 10- und 11-Upgrades mithilfe von Gruppenrichtlinien oder System Center Configuration Manager (SCCM) verschoben oder unterbrochen haben, aktivieren Sie Betriebssystem-Upgrades für Windows 10 und 11. WorkSpaces
+ Wenn das ein WorkSpace ist AutoStop WorkSpace, ändern Sie es AlwaysOn WorkSpace vor dem direkten Upgrade-Vorgang in ein, damit es nicht automatisch beendet wird, während Updates installiert werden. Weitere Informationen finden Sie unter [Ändern des Funktionsmodus](running-mode.md#modify-running-mode). Wenn Sie die WorkSpace Einstellung auf beibehalten möchten AutoStop, ändern Sie die AutoStop Zeit für die Dauer des Upgrades auf drei Stunden oder mehr.
+ Das direkte Upgrade erstellt das Benutzerprofil neu, indem eine Kopie eines speziellen Profils mit dem Namen „Standard-Benutzer“ (`C:\Users\Default`) erstellt wird. Verwenden Sie dieses Standardbenutzerprofil nicht, um Anpassungen vorzunehmen. Wir empfehlen stattdessen Anpassungen am Benutzerprofil über Gruppenrichtlinienobjekte (Group Policy Objects, GPOs). Anpassungen, die über Gruppenrichtlinienobjekte vorgenommen werden, können leicht geändert oder zurückgesetzt werden und sind weniger fehleranfällig.
+ Beim In-Place-Upgradeprozess kann nur ein Benutzerprofil gesichert und neu erstellt werden. Wenn Sie mehrere Benutzerprofile auf Laufwerk D haben, löschen Sie alle Profile mit Ausnahme des Profils, das Sie benötigen.

## Überlegungen
<a name="upgrade_byol_important_considerations"></a>

Der direkte Upgradevorgang verwendet zwei Registrierungsskripts (`enable-inplace-upgrade.ps1`und`update-pvdrivers.ps1`), um die notwendigen Änderungen an Ihrem vorzunehmen WorkSpaces , damit der Windows Update-Prozess ausgeführt werden kann. Diese Änderungen beinhalten das Erstellen eines (temporären) Benutzerprofils auf Laufwerk „C“ anstelle von Laufwerk „D“. Wenn auf Laufwerk „D“ bereits ein Benutzerprofil vorhanden ist, verbleiben die Daten in diesem ursprünglichen Benutzerprofil auf Laufwerk „D“.

Das Benutzerprofil wird standardmäßig in WorkSpaces `D:\Users\%USERNAME%` erstellt. Das Skript `enable-inplace-upgrade.ps1` konfiguriert Windows so, dass ein neues Benutzerprofil in `C:\Users\%USERNAME%` erstellt wird, und leitet die Benutzer-Shell-Ordner zu `D:\Users\%USERNAME%` um. Dieses neue Benutzerprofil wird erstellt, wenn sich ein Benutzer zum ersten Mal anmeldet.

Nach dem direkten Upgrade haben Sie die Möglichkeit, Ihre Benutzerprofile auf Laufwerk „C“ zu belassen, damit Ihre Benutzer ihre Computer zukünftig anhand des Windows Update-Prozesses aktualisieren können. Beachten Sie jedoch, dass WorkSpaces Profile, die auf Laufwerk C gespeichert sind, nicht neu erstellt oder migriert werden können, ohne dass alle Daten im Benutzerprofil verloren gehen, sofern Sie diese Daten nicht selbst sichern und wiederherstellen. Wenn Sie sich dafür entscheiden, die Profile auf Laufwerk C zu belassen, können Sie den ** UserShellFoldersRedirection ** Registrierungsschlüssel verwenden, um die Benutzer-Shell-Ordner auf Laufwerk D umzuleiten, wie weiter unten in diesem Thema erläutert.

Um sicherzustellen, dass Sie Ihre Benutzerprofile neu erstellen oder migrieren können, WorkSpaces und um mögliche Probleme mit der Benutzer-Shell-Ordnerumleitung zu vermeiden, empfehlen wir Ihnen, Ihre Benutzerprofile nach dem direkten Upgrade auf Laufwerk D wiederherzustellen. Sie können dies mithilfe des ** PostUpgradeRestoreProfileOnD ** Registrierungsschlüssels tun, wie weiter unten in diesem Thema erläutert. 

## Bekannte Beschränkungen
<a name="byol-known-limitations"></a>
+ Die Änderung des Speicherorts des Benutzerprofils von Laufwerk D auf Laufwerk C erfolgt nicht während WorkSpace Neuerstellungen oder Migrationen. Wenn Sie ein direktes Upgrade auf einem Windows 10- oder 11-BYOL durchführen WorkSpace und es dann neu erstellen oder migrieren, befindet sich das WorkSpace Benutzerprofil auf Laufwerk D.
**Warnung**  
Wenn Sie das Benutzerprofil nach dem direkten Upgrade auf Laufwerk „C“ belassen, gehen die auf Laufwerk „C“ gespeicherten Benutzerprofildaten bei einer Neuerstellung oder bei Migrationen verloren, es sei denn, Sie sichern die Benutzerprofildaten vor dem Neuerstellen oder Migrieren manuell und stellen die sie nach dem Neuerstellungs- oder Migrationsprozess manuell wieder her.
+ Wenn Ihr Standard-BYOL-Paket ein Image enthält, das auf einer früheren Version von Windows 10 und 11 basiert, müssen Sie das direkte Upgrade erneut durchführen, nachdem das WorkSpace neu erstellt oder migriert wurde.

## Zusammenfassung der Registrierungsschlüsseleinstellungen
<a name="upgrade_byol_registry_summary"></a>

Sie müssen eine Reihe von Registrierungsschlüsseln festlegen, um den direkten Upgrade-Prozess zu aktivieren und anzugeben, welches Benutzerprofil nach dem Upgrade vorhanden sein soll.


**Registrierungspfad: **HKL M:\\Software\\AmazonWorkSpacesConfig\\ enable-inplace-upgrade.ps1****  

| Registrierungsschlüssel | Typ | Werte | 
| --- | --- | --- | 
| Aktiviert | DWORD | **0** – (Standard) Deaktiviert In-Place-Upgrade<br />**1** – Ermöglicht ein In-Place-Upgrade | 
| PostUpgradeRestoreProfileOnD | DWORD | **0** – (Standard) Versucht nicht, den Benutzerprofilpfad nach dem In-Place-Upgrade wiederherzustellen<br />**1 ** — Stellt den Pfad des Benutzerprofils () nach dem direkten Upgrade wieder her ** ProfileImagePath ** | 
| UserShellFoldersRedirection | DWORD | **0** – Aktiviert nicht die Umleitung von Benutzer-Shell-Ordnern<br />**1** – (Standard) Aktiviert die Umleitung von Benutzer-Shell-Ordnern zu `D:\Users\%USERNAME%`, nachdem das Benutzerprofil auf `C:\Users\%USERNAME%` neu generiert wurde. | 
| NoReboot | DWORD | **0** – (Standard) Ermöglicht Ihnen zu steuern, wann ein Neustart erfolgt, nachdem die Registrierung für das Benutzerprofil geändert wurde<br />**1 ** — Erlaubt nicht, dass das Skript neu gestartet wird, WorkSpace nachdem die Registrierung für das Benutzerprofil geändert wurde | 


**Registrierungspfad: **HKL M:\\Software\\AmazonWorkSpacesConfig\\ update-pvdrivers.ps1****  

| Registrierungsschlüssel | Typ | Werte | 
| --- | --- | --- | 
| Aktiviert | DWORD | **0 ** — (Standard) Deaktiviert das PV-Treiber-Update AWS <br />**1 ** — Aktiviert das AWS PV-Treiber-Update | 

## Durchführen eines direkten Upgrades
<a name="upgrade_byol_procedure"></a>

Um direkte Windows-Upgrades auf Ihrem BYOL zu aktivieren WorkSpaces, müssen Sie bestimmte Registrierungsschlüssel einrichten, wie im folgenden Verfahren beschrieben. Sie müssen auch bestimmte Registrierungsschlüssel festlegen, um das Laufwerk (C oder D) anzugeben, auf dem sich die Benutzerprofile befinden sollen, nachdem die direkten Upgrades abgeschlossen wurden.

Sie können diese Registrierungsänderungen manuell vornehmen. Wenn Sie mehrere aktualisieren WorkSpaces müssen, können Sie mithilfe von Gruppenrichtlinien oder SCCM ein Skript per Push übertragen. PowerShell Ein PowerShell Beispielskript finden Sie unter[Aktualisieren Sie Ihre WorkSpace Registrierung mithilfe eines Skripts PowerShell](#update-windows-10-byol-script).

**So führen Sie ein direktes Upgrade von Windows 10 und 11 durch**

1. Notieren Sie sich, welche Version von Windows derzeit auf dem Windows 10- und 11-BYOL ausgeführt wird WorkSpaces , das Sie aktualisieren, und starten Sie sie dann neu.

1. Aktualisieren Sie die folgenden Systemregistrierungsschlüssel von Windows, um den Wert für **Aktiviert** von **0** bis **1** zu ändern. Diese Registrierungsänderungen ermöglichen direkte Upgrades für. WorkSpace
   + **HKEY\_LOCAL\_MACHINE\\ SOFTWARE\\ Amazon\\\\ enable-inplace-upgrade.ps1 WorkSpacesConfig **
   + **HKEY\_LOCAL\_MACHINE\\ SOFTWARE\\ Amazon\\WorkSpacesConfig\\ update-pvdrivers.ps1 **
**Anmerkung**  
Wenn diese Schlüssel nicht existieren, starten Sie den neu. WorkSpace Die Schlüssel sollten hinzugefügt werden, wenn das System neu gestartet wird.

   (Optional) Wenn Sie einen verwalteten Workflow wie SCCM-Tasksequenzen verwenden, um das Upgrade durchzuführen, legen Sie den folgenden Schlüsselwert auf **1** fest, um zu verhindern, dass der Computer neu gestartet wird.

   **HKEY\_LOCAL\_MACHINE\\ SOFTWARE\\ Amazon\\\\ enable-inplace-upgrade.ps1\\ WorkSpacesConfig NoReboot **

1. Entscheiden Sie, auf welchem Laufwerk sich Benutzerprofile nach dem In-Place-Upgrade befinden sollen (weitere Informationen finden Sie unter [Überlegungen](#upgrade_byol_important_considerations)), und legen Sie die Registrierungsschlüssel wie folgt fest:
   + Einstellungen, wenn sich das Benutzerprofil nach dem Upgrade auf Laufwerk „C“ befinden soll:

     **HKEY\_LOCAL\_MACHINE\\ SOFTWARE\\ Amazon\\WorkSpacesConfig\\ enable-inplace-upgrade.ps1 **

     Schlüsselname: ** PostUpgradeRestoreProfileOnD **

     Schlüsselwert: **0**

     Schlüsselname: ** UserShellFoldersRedirection **

     Schlüsselwert: **1**
   + Einstellungen, wenn sich das Benutzerprofil nach dem Upgrade auf Laufwerk „D“ befinden soll:

     **HKEY\_LOCAL\_MACHINE\\ SOFTWARE\\ Amazon\\\\ enable-inplace-upgrade.ps1 WorkSpacesConfig **

     Schlüsselname: ** PostUpgradeRestoreProfileOnD **

     Schlüsselwert: **1**

     Schlüsselname: ** UserShellFoldersRedirection **

     Schlüsselwert: **0**

1. Nachdem Sie die Änderungen an der Registrierung gespeichert haben, starten Sie die Registrierung WorkSpace erneut, damit die Änderungen übernommen werden.
**Anmerkung**  
Nach dem Neustart wird durch die Anmeldung bei der ein neues Benutzerprofil WorkSpace erstellt. Ihnen werden möglicherweise Platzhaltersymbole im **Start**-Menü angezeigt. Dieses Verhalten wird automatisch behoben, sobald das direkte Upgrade abgeschlossen ist.
Warten Sie 10 Minuten, um sicherzustellen, dass die Blockierung aufgehoben WorkSpace ist.

   (Optional) Vergewissern Sie sich, dass der folgende Schlüsselwert auf ** 1 gesetzt ist**, wodurch die Blockierung WorkSpace für die Aktualisierung aufgehoben wird:

   **HKEY\_LOCAL\_MACHINE\\ SOFTWARE\\ Amazon\\\\ enable-inplace-upgrade.ps1\\ profile WorkSpacesConfig ImagePathDeleted **

1. Durchführen des direkten Upgrades. Sie können alle Methoden verwenden, die Sie möchten, wie z. B. SCCM, ISO oder Windows Update (WU). Abhängig von Ihrer ursprünglichen Windows 10- und 11-Version und der Anzahl der installierten Apps kann dieser Vorgang zwischen 40 und 120 Minuten dauern.
**Anmerkung**  
Der In-Place-Upgrade-Vorgang kann mindestens eine Stunde dauern. Der WorkSpace Instanzstatus kann wie `UNHEALTHY` beim Upgrade angezeigt werden.

1. Nachdem der Aktualisierungsvorgang abgeschlossen ist, vergewissern Sie sich, dass die Windows-Version aktualisiert wurde.
**Anmerkung**  
Wenn das direkte Upgrade fehlschlägt, führt Windows automatisch ein Rollback durch, um die Windows 10- und 11-Version zu verwenden, die vor dem Start des Upgrades vorhanden war. Weitere Informationen zur Fehlerbehebung finden Sie in der [Microsoft-Dokumentation](https://docs.microsoft.com/en-us/windows/deployment/upgrade/resolve-windows-10-upgrade-errors).

   (Optional) Zur Bestätigung, dass die Aktualisierungs-Skripts erfolgreich ausgeführt wurden, stellen Sie sicher, dass der folgende Schlüsselwert auf **1** festgelegt ist:

   **HKEY\_LOCAL\_MACHINE\\ SOFTWARE\\ Amazon\\\\ enable-inplace-upgrade.ps1\\ script WorkSpacesConfig ExecutionComplete **

1. Wenn Sie den Betriebsmodus von geändert haben, indem Sie ihn auf AlwaysOn oder WorkSpace indem Sie den AutoStop Zeitraum so geändert haben, dass der direkte Upgrade-Vorgang ohne Unterbrechung ausgeführt werden kann, setzen Sie den Betriebsmodus auf Ihre ursprünglichen Einstellungen zurück. Weitere Informationen finden Sie unter [Ändern des Funktionsmodus](running-mode.md#modify-running-mode).

Wenn Sie den ** PostUpgradeRestoreProfileOnD ** Registrierungsschlüssel nicht auf ** 1 gesetzt haben**, wird das Benutzerprofil von Windows neu generiert und `C:\Users\%USERNAME%` nach dem direkten Upgrade eingefügt, sodass Sie die obigen Schritte bei zukünftigen direkten Windows 10- und 11-Upgrades nicht erneut ausführen müssen. Standardmäßig leitet das Skript `enable-inplace-upgrade.ps1` die folgenden Shell-Ordner zu Laufwerk „D“ um:
+ `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`

Wenn Sie die Shell-Ordner an andere Speicherorte auf Ihrem umleiten WorkSpaces, führen Sie die erforderlichen Vorgänge WorkSpaces nach den direkten Upgrades durch.

## Fehlerbehebung
<a name="byol-troubleshooting"></a>

Wenn Probleme bei der Aktualisierung auftreten, überprüfen Sie die folgenden Elemente zur Fehlerbehebung:
+ Windows-Protokolle, die sich standardmäßig an den folgenden Speicherorten befinden:

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

  `C:\Program Files\Amazon\WorkSpacesConfig\Logs\TRANSMITTED`
+ Windows-Ereignisanzeige

  Windows-Protokolle > Anwendung > Quelle: Amazon WorkSpaces

**Tipp**  
Wenn Sie während des direkten Upgrade-Vorgangs feststellen, dass einige Symbolverknüpfungen auf dem Desktop nicht mehr funktionieren, liegt das daran, dass alle Benutzerprofile, die sich auf Laufwerk D befinden, auf Laufwerk C WorkSpaces verschoben werden, um das Upgrade vorzubereiten. Nachdem das Upgrade abgeschlossen wurde, funktionieren die Verknüpfungen wie erwartet.

### Windows 11 24H2-Upgrade mit ISO-Fehlerauflösung
<a name="upgrade-iso-resolution"></a>

Beim Windows 11 24H2-Upgrade-Vorgang kann es in der zweiten Startphase zu einem kritischen Startfehler kommen, insbesondere mit dem Fehlercode 0xC1900101 - 0x40017. Dieser Fehler tritt normalerweise aufgrund einer fehlenden oder beschädigten Systemtreiberdatei auf, die verhindert, dass die Installation während der Startphase erfolgreich abgeschlossen wird.

*Fehlercode: * 0xC1900101 - 0x40017

*Fehlerbeschreibung: * Installationsfehler während der SECOND\_BOOT-Phase mit BOOT-Betriebsfehler

1. Stellen Sie sicher, dass Sie über die Windows 11 24H2-ISO-Datei verfügen.

1. Öffnen Sie eine Eingabeaufforderung als Administrator.

1. Kopieren Sie die erforderliche Systemdatei mit diesem Befehl:

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

   **ISO-Drive**Ersetzen Sie es durch Ihre ISO-Laufwerksinformationen.

1. Überprüfen Sie die Dateikopie mithilfe von:

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

1. Initiieren Sie das Windows 11 24H2-Upgrade mithilfe der ISO-Datei.

## Aktualisieren Sie Ihre WorkSpace Registrierung mithilfe eines Skripts PowerShell
<a name="update-windows-10-byol-script"></a>

Sie können das folgende PowerShell Beispielskript verwenden, um die Registrierung auf Ihrem WorkSpaces zu aktualisieren, um direkte Upgrades zu ermöglichen. Folgen Sie dem[Durchführen eines direkten Upgrades](#upgrade_byol_procedure), verwenden Sie jedoch dieses Skript, um die Registrierung auf jedem WorkSpace Gerät zu aktualisieren.

```
# 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
    }
}
```