(Optional) Downloading Software Offline and Integrating an ISO Driver

Scenarios

Download the software required by an image offline and integrate a VirtIO driver into an ISO file of an OS.

Procedure

1. Download an ISO file for creating an OS image as required, as shown in Table 1.

   Table 1 OS description

   OS	How to Obtain
   Windows 10	Click here.
   Windows Server 2016	Click here.
   Windows Server 2019	Click here.
   Windows Server 2022	Click here.
   Windows 11 Windows 11 Enterprise 23H2 Windows 11 Pro 24H2 Windows 11 Enterprise 24H2 Windows 11 Enterprise LTSC 2024 Windows 11 Pro 25H2	25H2: Click here. Other versions: Obtain proper OS ISO image files from Microsoft or other legal channels, depending on the user's desktop requirement type.

2. Download the software listed in Table 2 as required for creating a Windows private image.
   

   • When creating a Windows image, you can verify the integrity of the downloaded installation package and check whether any package is tampered with or lost during the download. For details, see Packages for Windows Image Creation.
   • If related software has been downloaded, you do not need to download Table 2.

   Table 2 Required software packages

   Software Package Name	Description	How to Obtain
   Workspace_HDP_WindowsDesktop_Installer_x.x.x.iso	Windows image creation tool	Click here to obtain the image creation tool. Click here to obtain the CMS signature file of the image creation tool.
   VirtIO driver package	VirtIO driver	Click here to download the required driver package (recommended version: virtio-win-0.1.266.iso) from the VirtIO official website.
   7z1900-x64.exe	7-Zip compression software, which is used to compress or decompress software packages	Click here.
   VC_redist.x64.exe	Visual Studio 2017 runtime library, which is used to install the basic library for running desktop applications	How to obtain: As of the document release date, click here to obtain.
   VC_redist.x86.exe
   CloudbaseInitSetup_xxx.msi	When using an image to create an ECS, you can customize the hostname, hosts file, username, and password of the ECS.	Download the appropriate version of Cloudbase-Init installation package based on the Windows bit. You are advised to download the latest version. Cloudbase-Init has two versions: stable and beta. To obtain the stable version, visit the following paths: 64-bit: Click here. 32-bit: Click here. To obtain the beta version, visit the following paths: 64-bit: Click here. 32-bit: Click here.
   HW.SysAgent.Installer_64.msi HW.SysPrep.Installer_64.msi	Used for desktop provisioning and HDA upgrade. Double-click to install it.	Click here to obtain HW.SysAgent. Click here to obtain the CMS signature file of HW.SysAgent. Click here to obtain HW.SysPrep. Click here to obtain the CMS signature file of HW.SysPrep.
   WKSAppCenterAgent.msi WKSAppCenter.msi	It needs to be installed when Workspace uses the application center. Double-click to install it.	Click here to obtain WKSAPPCenterAgent. Click here to obtain the CMS signature file of WKSAPPCenterAgent. Click here to obtain WKSAppCenter. Click here to obtain the CMS signature file of WKSAppCenter.
   Specifications	Product specifications supported for creating a Windows 11 image.	Ac8
   Windows Server 2016 OS patch	As of the document release date, the following patches must be obtained: KB3201845 and KB4013429 patches or cumulative patch updates released by Microsoft. NOTE: This patch needs to be installed only when you create a Windows Server 2016 image. KB3201845 applies only to Windows Server 2016 (Build 14393).	As of the document release date, the valid link is: https://www.microsoft.com/en-us Search for the patch by patch number on the website. You can prepare other OS patches based on your requirements.
   Make2023BootableMedia.ps1	Used to update the ISO file of Windows 11 23H2 NOTE: Only the ISO file of Windows 11 23H2 needs to be updated.	Click here. Click on the right of the script page to download.
   Peripheral driver	Prepare the peripheral drivers as required.	Prepared by users
   Application	Prepare application software as required, such as office and real-time communication software.	Prepared by users

3. Obtain the automation script. It is used to automatically download all software packages required for creating an image and integrate a VirtIO driver into the OS ISO file, as shown in Table 3.

   Table 3 Automation script description

   Script Name	How to Obtain
   WorkspaceISO_Customizer_International.ps1	Click here.

4. Create a directory (for example, C:\Script) on the local PC and save the ISO file and script downloaded in Table 1 and Table 3 to the directory.

   

5. Create a directory (for example, C:\Script\software) on the local PC and save Table 2 to the software directory.
   

   (Optional) If you need to install customized software, place all of them in the software folder.

6. On the local PC, press Win + S, search for Windows PowerShell, right-click it, and choose Run as administrator. The Windows PowerShell window is displayed.
7. Run the following command to go to the directory of the automation script:

   cd C:\Script

8. Run the following command to download the software and integrate the VirtIO driver into the ISO file:

   powershell -ExecutionPolicy Bypass -File WorkspaceISO_Customizer_International.ps1

   

   Run the preceding commands to run the script again. Do not close the script during the execution.

9. Wait until the script execution is complete and press Enter to exit.

   The ISO file of the OS will be generated in the output directory of the current directory (for example, C:\Script\output).

Updating Windows 11 Enterprise 23H2

Perform this operation only for Windows 11 23H2.

1. Go to the page and click on the right to download the ISO script for updating Windows 11 23H2.
2. On the local Windows device, search for Windows PowerShell in the Start menu, right-click it, and choose Run as administrator to open the Windows PowerShell window.
3. Run the following command to mount the ISO file:

   Mount-DiskImage -ImagePath "C:\Media\Windows11xxx.iso"

   Enter the actual ISO name.

4. Run the following command to view the drive letter:

   Get-DiskImage | Get-Volume

5. Run the following command to execute the script to update the Windows 11 23H2 OS:

   .\Make2023BootableMedia.ps1 -MediaPath "E:\" -TargetType ISO -ISOPath "C:\Media\Win11_Updated.iso"

   E:\ is the result obtained in 11. Replace it with the actual one.