Create and Manage MSIX App Attach Images and Host Pool Assignments

Create and Manage MSIX App Attach Images and Host Pool Assignments

This topic discusses how to do the following:

  • Upload an MSIX app attach image.

  • Upload an MSIX package file.

  • Assign an app to a host pool.

  • Create a new version of an app.

  • Change an app to a new version.

Sample VHD(X) Packages and Certificate

To help you get you started, we created a few VHD(X) packages for some popular applications that you can download and start using in your AVD environment for testing purposes.

Note: These packages are not intended for production purposes. They should be used for proof of concept testing.

Google Chrome

Mozilla Firefox

Notepad++

PuTTY

VLC

Certificate

  • The certificate can be downloaded here.

  • The certificate is the same for all the packages.

Upload an MSIX App Attach Image File

Nerdio Manager allows you to upload new versions of packages and automatically apply them to existing host pools. In addition, Nerdio Manager can create an image from an existing MSIX package, or you can upload an image file.

To upload an image:

  1. Navigate to ApplicationsMSIX app attach images.

  2. Select Upload image.

  3. Enter the following information:

    • Friendly Name: Type the name that you want to appear on the images list.

    • Description: Type a description.

    • Storage Location: From the drop-down list, select the linked app storage location in the AD-integrated Azure Files share.

      Note: MSIX App Attach does not support Entra Domain Services or Entra ID. This needs to be Active Directory Domain Services (ADDS).

    • Version: Type the version number of the image that you are uploading. This must be unique.

    • Image File(s): Select the VHD(X)/CIM file(s) that contains the App Attach application expanded from the MSIX installer.

    • Certificate (.cer) File: Select the certificate file.

      Note: A certificate that was used to create the MSIX package must be installed on all session hosts VMs. If you used a self-signed certificate to create the MSIX package, upload it here and it is automatically installed for you. Alternatively, you can install the certificate on the desktop image and re-image the session host VMs

  4. Once you have entered all the desired information, select Upload.

    The image is uploaded to Nerdio Manager.

Upload an MSIX Package File

This feature is only available in the Nerdio Manager Premium edition.

If you do not already have a VHD/VHDX./CIM that contains the image, Nerdio Manager allows you to upload the MSIX file and Nerdio Manager automatically creates a VHD file for you.

To upload an MSIX package file:

  1. Navigate to ApplicationsMSIX app attach images.

  2. Select Upload MSIX app(s).

  3. Enter the following information:

    • Image Name: Type the image name.
    • Storage Location: From the drop-down list, select the linked app storage location in the AD-integrated Azure Files share.

    • MSIX File(s): Select the MSIX file(s).

    • Certificate (.cer) File(s): Optionally, select the certificate file(s).

      Note: To expand the MSIX app into a VHDX container, a temporary VM is created to perform the operation and then deleted. It is recommended that you simply let Nerdio Manager handle the temporary VM's configuration. Otherwise, select Show advanced settings to specify the temporary VM's details.

  4. Once you have entered all the desired information, select OK.

    The MSIX file is uploaded, and Nerdio Manager begins the process of creating a VM to package the file into a VHDX image.

Assign an App to a Host Pool

Once you have uploaded an MSIX app attach image, you can assign the app to a host pool.

To assign an app to a host pool:

  1. Locate the host pool you wish to assign the app to.

  2. From the action menu, select ApplicationsMSIX app attach.

  3. When the Manage MSIX App Attach window displays, select Add.

  4. Enter the following information:

    • Image Source: From the drop-down list, select the location of the image that contains MSIX packages. The image can be stored in Nerdio Manager's image library or on any SMB file share that session host VMs have access to. If you have uploaded or created MSIX images using Nerdio Manager, select Image Library.

    • MSIX App Attach Image: From the drop-down list, select an MSIX App Attach image containing the MSIX packages.

    • Image Version: From the drop-down list, select the image's version to be added to the host pool.

    • Packages: From the drop-down list, select one or more MSIX packages/apps present in the image to make available to users on this host pool.

      Notes:

      • The package in the file share closest to the host pool’s region is prioritized to reduce latency.

      • Ensure that the host pool has at least one running session host VM.

      • Each VM in the host pool must have certificates that were used to sign MSIX installed. Select Install certificates to install them if they aren't already.

  5. Once you have entered all the desired information, select OK.

    The MSIX app is added to the host pool.

Assign an App Attach v2 App to Users and Groups

Once you have uploaded an MSIX App Attach v2, you can assign the app to users and groups.

To assign an App Attach v2 app to users and groups:

  1. Navigate to ApplicationsMSIX app attach images.

  2. Locate the App Attach v2 app you want to work with.

  3. From the action menu, select Users and groups.

  4. From the drop-down list, select the Users and Groups.

  5. Once you have entered all the desired information, select OK.

    The MSIX app is assigned to the users and groups.

Create a New Version of an App

Nerdio Manager allows you to manage multiple versions of an app.

To add a new version of an app:

  1. Navigate to ApplicationsMSIX app attach images.

  2. Locate the image you want to add an app to.

  3. From the action menu, select Upload new image version.

  4. Enter the following information:

    • Version: Type the version number of the image that you are uploading. This must be unique.
    • Image File(s): Select the VHD(X)/CIM file(s) that contains the App Attach application expanded from the MSIX installer.

    • Certificate (.cer) File(s): Optionally, select the certificate file(s).

      Note: A certificate that was used to create the MSIX package must be installed on all session hosts VMs. If you used a self-signed certificate to create the MSIX package, upload it here and it is automatically installed for you. Alternatively, you can install the certificate on the desktop image and re-image the session host VMs.

  5. Once you have entered all the desired information, select Upload.

    The image is uploaded to Nerdio Manager

Change to a New Version of an App

Nerdio Manager allows you to change to a new version an app.

To change to a new version of an app:

  1. Navigate ApplicationsMSIX app attach images.

  2. Locate the image you want to work with.

  3. Select Image versions. The list of image versions displays.

  4. Locate the image version you wish to set as the default.

  5. Select Set as default. The confirmation window displays.

  6. Select Update host pools where this package is assigned to assign the new version of the image to the host pools listed above.

  7. Select OK.

    The new version is now the default.

Upload a New Image Version of an App

Nerdio Manager allows you to upload a new image version an app.

To upload a new image version of an app:

  1. Navigate ApplicationsMSIX app attach images.

  2. Locate the image you want to work with.

  3. From the action menu, select Upload a new Image version.

  4. Enter the following information:

    • Version: Type the version number of the image that you are uploading. This must be unique.

    • Storage Location: From the drop-down list, select the linked app storage location in the AD-integrated Azure Files share.

    • Image File(s): Select the VHD(X)/CIM file(s) that contains the App Attach application expanded from the MSIX installer.

    • Certificate (.cer) File(s): Optionally, select the certificate file(s).

  5. Once you have entered all the desired information, select Upload.

Was this article helpful?

0 out of 0 found this helpful
Have more questions? Submit a request

Comments (0 comments)

Article is closed for comments.