MSIX app attach glossary

This article is a list of definitions for key terms and concepts related to MSIX app attach.

MSIX container

An MSIX container is where MSIX apps are run. To learn more, see MSIX containers.

MSIX application

An application stored in an MSIX file.

MSIX package

An MSIX package is an MSIX file or application.

MSIX share

An MSIX share is a network share that holds expanded MSIX packages. MSIX shares support SMB 3 or later. Applications get staged from this MSIX share without having to move application files to the system drive.

Repackage

Repackaging takes a non-MSIX application and converts it into MSIX using the MSIX Packaging Tool (MPT). For more information, see MSIX Packaging Tool overview.

Expand

Expanding MSIX package is a multi-step process. It takes the MSIX file and put its content into a VHD(x) or CIM file.

To expand an MSIX package:

  1. Get an MSIX package (MSIX file).
  2. Rename the MSIX file to a .zip file.
  3. Unzip the resulting .zip file in a folder.
  4. Create a VHD that's the same size as the folder.
  5. Mount the VHD.
  6. Initialize a disk.
  7. Create a partition.
  8. Format the partition.
  9. Copy the unzipped content into the VHD.
  10. Use the MSIXMGR tool to apply ACLs on the content of the VHD.
  11. Unmount the VHD(x) or CIM.

Upload an MSIX package

Uploading an MSIX package involves uploading the VHD(x) or CIM that contains an expanded MSIX package to the MSIX share.

In Windows Virtual Desktop, uploads happen once per MSIX share. Once you upload a package, all host pools in the same subscription can reference it.

Publish an MSIX package

In Windows Virtual Desktop, publishing an MSIX package links it to a remote app or desktop.

Assign an MSIX package

In Windows Virtual Desktop, a published MSIX package must be assigned to an Active Directory Domain Service (AD DS) or Azure Active Directory (Azure AD) user or user group.

Staging

Staging involves two things:

  • Mounting the VHD(x) or CIM to the VM.
  • Notifying the OS that the MSIX package is available for registration.

Registration

Registration makes a staged MSIX package available for your users. Registering is on a per-user basis. If you haven't explicitly registered an app for that specific user, they won't be able to run the app.

There are two types of registration: regular and delayed.

Regular registration

In regular registration, each application assigned to a user is fully registered. Registration happens during the time the user signs in to the session, which might impact the time it takes for them to start using Windows Virtual Desktop.

Delayed registration

In delayed registration, each application assigned to the user is only partially registered. Partial registration means that the Start menu tile and double-click file associations are registered. Registration happens while the user signs in to their session, so it has minimal impact on the time it takes to start using Windows Virtual Desktop. Registration completes only when the user runs the application in the MSIX package.

Delayed registration is currently the default configuration for MSIX app attach.

Deregistration

Deregistration removes a registered but non-running MSIX package for a user. Deregistration happens while the user signs out of their session. During deregistration, MSIX app attach pushes application data specific to the user to the local user profile.

Destage

Destaging notifies the OS that an MSIX package or application that currently isn't running and isn't staged for any user can be unmounted. This removes all reference to it in the OS.

CIM

.CIM is a new file extension associated with Composite Image Files System (CimFS). Mounting and unmounting CIM files is faster that VHD files. CIM also consumes less CPU and memory than VHD.

The following table is a performance comparison between VHD and CimFS. These numbers were the result of a test run with five hundred 300 MB files in each format run on a DSv4 machine.

Specs VHD CimFS
Average mount time 356 ms 255 ms
Average unmount time 1615 ms 36 ms
Memory consumption 6% (of 8 GB) 2% (of 8 GB)
CPU (count spike) Maxed out multiple times No impact

Next steps

If you want to learn more about MSIX app attach, check out our overview and FAQ. Otherwise, get started with Set up app attach.