Citrix Virtual Apps and Desktops

Install VDAs using Microsoft Intune

Overview

This article describes how to deploy VDAs using Microsoft Intune. For more information, see the Microsoft documentation.

Note:

The following article describes only recommendations based on how Citrix has tested the environment. You can customize these steps according to your needs. Citrix is not responsible for any updates or tweaks needed to this to fit customer needs.

Key steps to deploy VDA using Microsoft Intune

  1. Prepare installation for the Citrix VDA.
  2. Set up Microsoft 365 Developer Program Subscriber.
  3. Add and assign an app.
  4. Install the app on the enrolled device.

Step 1: Prepare installation for the Citrix VDA

  1. Download the updated IntuneWinAppUtil.exe from GitHub.
  2. Run the IntuneWinAppUtil.exe file using Run as administrator.
  3. Enter the following data:

    MS Intune

    1. Please specify the source folder: Enter the folder that contains your application setup files. For example, C:\source\Citrix.
    2. Please specify the setup file: Enter the setup file name (such as setup.exe or setup.msi). For example, VDAWorkstationSetup_2203.exe.
    3. Please specify the output folder: Enter the path of the output folder to generate the .intunewin file. For example, C:\source\Citrix.
    4. Do you want to specify catalog folder (Y/N): Type N.

    Note:

    Wait a few minutes while Win32 Content Prep Tool is running. Once it generates the .intunewin file, the status indicates 100% at the bottom of the command prompt.

  4. Once the process completes, go to the output folder (In this example, C:\source\Citrix) to get the Microsoft Intune deployment file.

  5. Sign up for a Microsoft Intune free trial.

    Microsoft Intune free trial

Step 2: Set up Microsoft 365 Developer Program Subscriber

  1. Create the Instant sandbox to activate your subscription. To get your developer sandbox, go to your Microsoft 365 Developer Program dashboard and select Add a new subscription.

    MS Intune

  2. Create a user in the Microsoft 365 Admin center and assign a license to the user.

    M365 admin developer program

  3. Create a group.

    Create group

  4. Once the group is created, you must provide the MDM authority to the group. Set up automatic enrollment. It can take a minute to activate. Or you can manually add the MDM authority to the group by completing the following steps:
    1. Go to All services > Microsoft Entra.
    2. Go to settings > Mobility and select Microsoft Intune.
    3. Select the group you have just created. This opens a page with the MDM user scope.
    4. Click Save.
  5. In the All Services tab, click M365 Azure Active Directory.

    Admin center

  6. Click Get a free Premium trial to use this feature. Intune MDM

  7. Click Activate.

    MS Entra center

  8. Now, click Microsoft Intune.

    Select MS Intune

  9. In the Configure tab, enter the required configurations.

    Configuration

  10. To add a group, click No groups selected.

    Select a group

  11. Enroll your device.

    Enrol a device

  12. Create a device compliance policy to change your newly created Device’s compliance to Compliant.

    Compliance policy

  13. Go to the Assignments tab to add the newly created group.

    Fully managed

  14. Confirm the device enrollment.

    Device enrolment

For detailed information, see Microsoft 365 developer program.

Step 3: Add and assign an app

  1. Sign in to Microsoft Intune admin center.

  2. Select Apps > All apps > Add or go to Apps > Windows > Windows Apps.

    Select app type

  3. On the Select app type pane, select Other app types > Windows app (Win32) and click Select.

  4. On the Add app pane, click Select app package file. Click browse.

  5. Select the prepared file with the extension .intunewin. The prepared file is created during the Prepare installation for the Citrix VDA step. A page containing detailed information about the app is displayed.

    App package

    Note:

    • If you are using a server-core machine, you must use the VDA workstation core.
    • If you are using a Windows 10 desktop OS, you must use the VDA workstation.
    • If you are using a server OS (For example, Windows 2022), you must use the VDA server setup.
    • In this example, we are using the 2203 version but this is applicable for all versions.
  6. Click OK on the App package file pane.

  7. In the following screen, under the App Information tab, enter the Name of the App, and enter the Description of the Windows App. Enter the Publisher name as Citrix, and you can specify the additional app information here. Click Next.

    Intune add app

  8. On the next screen, enter the following values:

    • Install command: VDAWorkstationSetup_2203.exe /quiet /noreboot
    • Uninstall command: VDAWorkstationSetup_2203.exe /quiet /removeall /noreboot
    • Install behavior:
      • System: Select this option to install the app on all the devices in the group.
      • User: Select this option to install the app only on a specific user device in the group.
  9. Click Next.

    Note:

    • This example uses the 2203 version, but you can use it with any version.
    • Adding /noreboot to a command doesn’t mean there won’t be any reboots during installation or deployment, but only enforces mandatory reboots. For more information on scripts, see Command-line options for installing a VDA.
    • For Device restart behavior, select Intune will force a mandatory device restart.
    • In the Return code text box, enter 0, 3 and 8 for post-installation success. For information on other return codes, see Citrix installation return codes.

    Intune add app

  10. In the following screen, under the Requirements tab, enter the required values. Click Next.

    Intune add app

  11. In the following screen, under the Detection rule tab, add Detection rule to add the Broker agent. Click OK.

    Detection rule

  12. In the Assignments tab, you can add the devices in the following:
    • Required: The devices for which updates occur automatically.
    • Available for enrolled devices: The devices for which updates occur manually.

    Add app more

  13. Review the details and click Create.

    Admin center

    The app is assigned successfully.

    Assigned app

For detailed information, see Add and assign an app.

Step 4: Install the app on the enrolled device

  1. Sign in to your enrolled Windows 10 Desktop device. The device must be enrolled with Microsoft Intune. Also, you must sign in to the device using an account contained in the group you assigned to the app. For more information, see the Microsoft documentation.

  2. From the Start menu, open Microsoft Store.

  3. Browse for the Company Portal app and install it.

    Intune company portal

  4. Run the Company Portal app.

  5. Click the app that you added using Microsoft Intune. If you did not successfully assign any apps to the Intune user, the following message is displayed: Your IT administrator did not make any apps available to you.

  6. Click Install.

Install VDAs using Microsoft Intune