Deployment with Intune
  • 28 Oct 2023
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Deployment with Intune

  • Dark
    Light
  • PDF

Article summary

Microsoft Windows only

The information in this article is applicable only for devices with Windows OS.

Instead of manually converting multiple apps that you need into .intunewin files and then upload and configure them individually in Microsoft Intune, you can just add the Liquit Agent Bootstrapper to Microsoft Intune and then deploy multiple apps at once.
As currently there is no possibility to enroll a machine running the Liquit Agent with Microsoft Intune, because the Liquit Workspace configuration file cannot be added, there are only two ways to integrate Liquit with Microsoft Intune: either by adding the Liquit Agent Bootstrapper within Microsoft Intune, or creating a Bootstrapper script.
The following step by step instructions will help you deploy the bootstrapper within Microsoft Intune.

Download required tools

First you need to download the latest version of the bootstrapper and latest version of IntuneWinAppUtil.

Configure the Agent

Next you need to create a valid Agent configuration. See Agent Configuration for the Liquit Workspace Agent or Agent Configuration for Liquit Universal Agent for more information on creating an Agent configuration file.

It is important to have the following settings configured:

  • The device must be configured to register itself with credentials or certificate, depending on the type of the Agent.
  • Context set to Device.
  • Deployment.Autostart.Enabled set to true.
  • Deployment.Enabled set to true.
  • Deployment.Start set to false. The deployment start must be false because the bootstrapper and the installer will automatically trigger the deployment.
Important

If you run the installer without the bootstrapper remember to set these flags correctly.

Agent.XML example

<Register>
    <Type>1</Type>
    <Username><![CDATA[LOCAL\wksimport]]></Username>
    <Password><![CDATA[P@ssw0rd]]></Password>
</Register>
<Deployment>
    <Enabled>True</Enabled>
    <Start>False</Start>
    <Cancel>False</Cancel>
    <Events>False</Events>
    <Context>Device</Context>
    <AutoStart>
        <Enabled>True</Enabled>
        <Timer>0</Timer>
        <Deployment>LIQUIT</Deployment>
    </AutoStart>
</Deployment>

Agent.JSON example

{
    "zone":"https://example.liquit.com",
    "registration": {
        "type": "Certificate"
    },
    "log": {
        "level": "Debug"
    },
    "deployment": {
        "enabled": true,
        "start": false,
        "context": "device",
        "cancel": true,
        "triggers": false,
        "autoStart": {
            "enabled": true,
            "deployment": "LIQUIT",
            "timer": 0
        }
    }
}

Prepare app for Microsoft Intune

  1. Create a folder and copy the Agent.XML/Agent.JSON, AgentBootstrapper.exe and if configured, the AgentRegistration.cer to it.
    bootstrapper-intune-files.png

  2. Start IntuneWinAppUtil.exe as Administrator from any folder and navigate to the folder of the Agent.XML and AgentBootstrapper.exe. Press Enter.
    image.png

  3. Specify a setup file. In our case this is AgentBootstrapper-1.0.0.2.exe. Press Enter.
    bootstrapper-intune-setup-file.png

  4. Specify the output folder. For example "C:\Output". Press Enter
    bootstrapper-intune-output-folder.png

  5. When prompted for the catalog folder, press "N". Press Enter.
    bootstrapper-intune-catalog-folder.png

  6. Navigate to the output folder to find the .intunewin file.
    bootstrapper-intune-intunewinfile.png

Upload .intunewin file to Microsoft Intune

The final step in this setup is to upload the .intunewin file you created to Microsoft Intune.

  1. Go to Microsoft Intune admin center.
  2. Select Apps > By platform > Windows > + Add.
  3. On the Select app type pane, under the Other app types, select Windows app (Win32) and then click Select.
    image.png
  4. At the top of the Add app pane that appears, click Select app package file.
  5. On the App package file pane, select the browse button. Select the agent bootstrapper .intunewin file you created. Select OK on the App package file pane.
  6. On the App information page, add the necessary details and click Next.
  7. On the Program page, specify the following commands and click Next.
    • the install command (see Installation of Liquit Agent Bootstrapper). For example:
      AgentBootstrapper-2.0.0.6.exe /startDeployment /waitForDeployment /logPath=.\Install /certificate=".\AgentRegistration.cer"
      If you’re using a certificate to register, specify the name and path.
      If you want to deploy a Liquit Workspace Agent and not the Liquit Universal Agent, specify the /legacyDownloadparameter. This is for the 3.10 agent or pre 4.0 servers.
    • the uninstall command, for example AgentBootstrapper-2.0.0.6.exe /uninstall
  8. On the Requirements page, add the necessary details and click Next.
  9. On the Detection rules page, create a detection script for the Agent.exe. For example:
# Check if the Liquit Agent is installed on a Windows system
# Version 1.1
# Date created 25-05-2023
# Copyright 2023 Liquit Software B.V.

# This example script is provided AS IS.

# Set the file paths to search for
$Paths = @(    
    "C:\Program Files\Liquit Universal Agent\Agent.exe",
    "C:\Program Files (x86)\Liquit Universal Agent\Agent.exe",
    "C:\Program Files (x86)\Liquit Workspace\Agent\Agent.exe"
)

# Check if the file exists and is a leaf object (agent.exe)
foreach ($Path in $Paths) {
    if (Test-Path $Path -PathType Leaf) {

        # Uncomment for output
        # Write-Output ("Liquit Workspace is installed at " + $Path)

        # Exit if true
        Exit 0
    }
}

# Return false is not exist
Exit 1

If you signed the script, you can enable the option Enforce script signature check to run the script silently.

  1. On the Dependencies page click Next.
  2. On the Assignments page, assign it to devices, users or groups as needed. Click Next.
  3. On Review + create page, review the values and settings that you entered for the app. Click Create to add the bootstrapper to Microsoft Intune.

After all the configurations are done, we encourage you to test the deployment.

Further reading

Microsoft Intune documentation: Prepare a Win32 app to be uploaded to Microsoft Intune | Microsoft Docs

IntuneWinAppUtil tool: GitHub - microsoft/Microsoft-Win32-Content-Prep-Tool: A tool to wrap Win32 App and then it can be uploaded to Intune


Was this article helpful?

What's Next