Deploying TELAIR Connect PWA via Microsoft Intune
| Document ID | KB-INTUNE-PWA-001 |
| Applies To | Windows 10/11, Microsoft Edge, Microsoft Intune |
Overview
Section titled “Overview”This article describes how to automatically deploy the TELAIR Connect Progressive Web App (PWA) to Windows devices using Microsoft Intune. Once deployed, the application will install silently on enrolled devices and appear in the Start menu and optionally on the desktop.
Progressive Web Apps are web applications that provide an app-like experience without requiring installation from an app store. They run in Microsoft Edge but appear and behave like native desktop applications, with their own window and taskbar presence.
Prerequisites
Section titled “Prerequisites”- Devices must be enrolled in Microsoft Intune
- Microsoft Edge must be installed on target devices
- Edge must be launched at least once before the PWA will install
- Administrator access to the Microsoft Intune admin center
- Users must have network access to triton-ca2.telair.net
Configuration Steps
Section titled “Configuration Steps”Step 1: Access Intune Configuration Profiles
Section titled “Step 1: Access Intune Configuration Profiles”- Sign in to the Microsoft Intune admin center at https://intune.microsoft.com
- In the left navigation pane, select Devices
- Select Windows
- Click Configuration profiles
Step 2: Create a New Configuration Profile
Section titled “Step 2: Create a New Configuration Profile”- Click + Create and select New Policy
- For Platform, select Windows 10 and later
- For Profile Type, select Settings catalog
- Click Create
Step 3: Configure Basic Settings
Section titled “Step 3: Configure Basic Settings”- Enter a descriptive name for the profile (e.g., “Edge - Install PWA - TELAIR Connect”)
- Optionally enter a description
- Click Next
Step 4: Add the PWA Installation Setting
Section titled “Step 4: Add the PWA Installation Setting”- In Configuration settings, click + Add settings
- In the Settings picker, search for “WebAppInstallForceList”
- Select Microsoft Edge from the category list
- Select Configure list of force-installed Web Apps (the Device setting)
- Close the settings picker
Step 5: Enter the PWA Configuration
Section titled “Step 5: Enter the PWA Configuration”- Toggle the Configure list of force-installed Web Apps setting to Enabled
- In the “URLs for Web Apps to be silently installed” field, enter the following JSON configuration:
[ { "url": "https://triton-ca2.telair.net/connect/app", "custom_name": "TELAIR Connect", "create_desktop_shortcut": true, "default_launch_container": "window" }]- Click Next to proceed
Step 6: Assign the Profile
Section titled “Step 6: Assign the Profile”- In the Assignments tab, click Add groups
- Select the device groups or user groups that should receive the PWA
- Alternatively, select Add all devices or Add all users for organization-wide deployment
- Click Next
Step 7: Review and Create
Section titled “Step 7: Review and Create”- Review all settings in the Review + create tab
- Click Create to deploy the configuration profile
JSON Configuration Options
Section titled “JSON Configuration Options”The following table describes all available configuration options for PWA deployment:
| Property | Required | Description |
|---|---|---|
url | Yes | The URL of the web application to install |
custom_name | No | Display name for the app (uses site name if not specified) |
create_desktop_shortcut | No | If true, creates a desktop shortcut |
default_launch_container | No | ”window” for standalone app, “tab” for browser tab |
fallback_app_name | No | Name to use if site doesn’t provide one |
custom_icon | No | Custom icon URL (hash and url properties) |
Verification
Section titled “Verification”After the policy applies to a device, verify the PWA installation using these methods:
- Check for the TELAIR Connect shortcut on the desktop (if enabled) and in the Start menu
- Open Microsoft Edge and navigate to
edge://appsto see installed web apps - Check Windows Settings > Apps > Installed apps for “TELAIR Connect”
- In Intune, monitor the configuration profile deployment status under Devices > Configuration profiles > [Profile Name] > Device status
Troubleshooting
Section titled “Troubleshooting”PWA does not appear on the device
Section titled “PWA does not appear on the device”- Ensure Microsoft Edge has been launched at least once on the device
- Verify the device has synced with Intune (Settings > Accounts > Access work or school > Info > Sync)
- Check the configuration profile assignment to ensure the device is targeted
- Allow time for policy to propagate (can take several hours)
Icon appears generic or missing
Section titled “Icon appears generic or missing”- The icon may take a few minutes to fully load after initial installation
- Ensure the device can reach the PWA URL to fetch the manifest and icons
Configuration profile shows conflict
Section titled “Configuration profile shows conflict”- Multiple configuration profiles with WebAppInstallForceList will conflict
- Consolidate all PWA definitions into a single configuration profile
Checking Event Logs
Section titled “Checking Event Logs”Intune policy application can be verified in Event Viewer under:
Applications and Services Logs > Microsoft > Windows > DeviceManagement-Enterprise-Diagnostics-Provider > AdminLook for Event ID 814 which indicates string policy application.
Important Notes
Section titled “Important Notes”- Users cannot uninstall force-installed PWAs while the policy is applied
- The PWA will be removed if the device is unenrolled from Intune or the policy is removed
- Pinning to taskbar or Start menu is not automatic; users will be prompted on first launch
- This method requires Microsoft Edge; Chrome requires a separate policy