Prepare an MSIX image for Azure Virtual Desktop

MSIX app attach is an application layering solution that allows you to dynamically attach apps from an MSIX package to a user session. The MSIX package system separates apps from the operating system, making it easier to build images for virtual machines. MSIX packages also give you greater control over which apps your users can access in their virtual machines. You can even separate apps from the master image and give them to users later.

Instructions on how to convert a desktop installer (such as MSI, EXE, ClickOnce, App-V, or Script) to MSIX are available in Create an MSIX package from any desktop installer (MSI, EXE, ClickOnce, or App-V).

Create a VHD or VHDX package for MSIX

MSIX packages need to be in a VHD or VHDX format to work properly. This means that, to get started, you'll need to create a VHD or VHDX package.


If you haven't already, make sure you enable Hyper-V by following the instructions in Install Hyper-V on Windows 10.

To create a VHD or VHDX package for MSIX:

  1. First, open PowerShell.

  2. Next, run the following cmdlet to create a VHD:

    New-VHD -SizeBytes <size>MB -Path c:\temp\<name>.vhd -Dynamic -Confirm:$false


    Make sure the VHD is large enough to hold the expanded MSIX package.

  3. Run the following cmdlet to mount the VHD you just created:

    $vhdObject = Mount-VHD c:\temp\<name>.vhd -Passthru
  4. Next, run this cmdlet to initialize the mounted VHD:

    $disk = Initialize-Disk -Passthru -Number $vhdObject.Number
  5. After that, run this cmdlet to create a new partition for the initialized VHD:

    $partition = New-Partition -AssignDriveLetter -UseMaximumSize -DiskNumber $disk.Number
  6. Run this cmdlet to format the partition:

    Format-Volume -FileSystem NTFS -Confirm:$false -DriveLetter $partition.DriveLetter -Force
  7. Finally, create a parent folder on the mounted VHD. This step is required because the MSIX package must have a parent folder to work properly. It doesn't matter what you name the parent folder, so long as the parent folder exists.

Expand MSIX

After that, you'll need to expand the MSIX image by "unpacking" its files into the VHD.

To expand the MSIX image:

  1. Download the msixmgr tool and save the .zip folder to a folder within a session host VM.

  2. Unzip the msixmgr tool .zip folder.

  3. Put the source MSIX package into the same folder where you unzipped the msixmgr tool.

  4. Open a command prompt as Administrator and navigate to the folder where you downloaded and unzipped the msixmgr tool.

  5. Run the following cmdlet to unpack the MSIX into the VHD you created in the previous section.

    msixmgr.exe -Unpack -packagePath <package>.msix -destination "f:\<name of folder you created earlier>" -applyacls

    The following message should appear after you're done unpacking:

    Successfully unpacked and applied ACLs for package: <package name>.msix


    If you're using packages from the Microsoft Store for Business or Education on your network or on devices not connected to the internet, you'll need to download and install package licenses from the Microsoft Store to run the apps. To get the licenses, see Use packages offline.

  6. Go to the mounted VHD and open the app folder to make sure the package contents are there.

  7. Unmount the VHD.

Upload MSIX image to share

After you've created the MSIX package, you'll need to upload the resulting VHD, VHDX, or CIM file to a share where your users' virtual machines can access it.

Next steps

Ask our community questions about this feature at the Azure Virtual Desktop TechCommunity.

You can also leave feedback for Azure Virtual Desktop at the Azure Virtual Desktop feedback hub.

Here are some other articles you might find helpful: