Microsoft Intune
This guide walks you through deploying Voquill to Windows devices in your organization using Microsoft Intune. The deployment consists of two parts: the Voquill app itself and a configuration script that connects it to your enterprise gateway.
Prerequisites
Section titled “Prerequisites”- Microsoft Intune admin access
- Microsoft Win32 Content Prep Tool installed
- A configured Voquill Enterprise gateway (see On-Premise Setup or your cloud deployment)
Part 1: Deploy the Voquill App
Section titled “Part 1: Deploy the Voquill App”1. Download the Latest MSI
Section titled “1. Download the Latest MSI”Download the latest Voquill Windows MSI from the GitHub releases page. Look for a file named Voquill_x.x.x_x64_en-US.msi.
Create a folder for your Intune package:
C:\IntunePackages\Voquill\Place the downloaded MSI in this folder.
2. Create the .intunewin Package
Section titled “2. Create the .intunewin Package”Use the Microsoft Win32 Content Prep Tool to package the MSI:
IntuneWinAppUtil.exe -c "C:\IntunePackages\Voquill" -s "Voquill_x.x.x_x64_en-US.msi" -o "C:\IntunePackages\Output"This creates Voquill_x.x.x_x64_en-US.intunewin in the output folder.
3. Add the App in Intune
Section titled “3. Add the App in Intune”- Sign in to the Microsoft Intune admin center
- Navigate to Apps > All apps > Add
- Select Windows app (Win32) as the app type
- Click Select and upload your
.intunewinfile
4. Configure the App
Section titled “4. Configure the App”Complete the app wizard using the default settings. Fill in basic app information (name, description, publisher) as needed.
5. Assign the App
Section titled “5. Assign the App”- Go to the Assignments tab
- Under Required, click Add group and select the groups that should receive Voquill
- Click Next and then Create
Part 2: Deploy the Enterprise Configuration
Section titled “Part 2: Deploy the Enterprise Configuration”Use Intune’s Platform Scripts feature to deploy the enterprise configuration to each device.
1. Create the Configuration Script
Section titled “1. Create the Configuration Script”Create a PowerShell script named Configure-Voquill.ps1:
$enterpriseJson = @'{ "gatewayUrl": "http://your-gateway-host:4630"}'@
$basePath = Join-Path $env:APPDATA "com.voquill.desktop"$filePath = Join-Path $basePath "enterprise.json"
if (!(Test-Path $basePath)) { New-Item -ItemType Directory -Path $basePath -Force | Out-Null}
Set-Content -Path $filePath -Value $enterpriseJson -Encoding UTF8Replace your-gateway-host:4630 with the actual hostname and port of your Voquill Enterprise gateway.
2. Add the Script in Intune
Section titled “2. Add the Script in Intune”- In the Intune admin center, navigate to Devices > Scripts and remediations > Platform scripts
- Click Create
- Enter a name (e.g., “Configure Voquill Enterprise”) and click Next
- Upload your
Configure-Voquill.ps1script
3. Configure Script Settings
Section titled “3. Configure Script Settings”Set Enforce script signature check to No. Leave the other settings at their defaults.
4. Assign the Script
Section titled “4. Assign the Script”- Go to the Assignments tab
- Select the same groups that receive the Voquill app
- Click Next and then Create
Verification
Section titled “Verification”After deployment, open Voquill and check that your company name appears under the username. If it says “community” instead, the enterprise configuration was not applied correctly.