Configurer l'agent WinAppack dans Intune

All policies configure the following registry keys : HKLM\SOFTWARE\Policies\WinAppack\...

The WinAppack Agent relies on the values of these registry keys (see Verify the configuration at the end of this page).

Minimum configuration

The WinAppack Agent applies the Intune configuration only when these two policies are set:

If one of them is missing, all the other policies have no effect.

All the other policies are optional: when a policy is not configured, the Agent uses its default value. With this minimum configuration, all the software of the catalog is available in the user interface and users can install or uninstall it themselves (see the DefaultDeployment policy).

⚠️ Devices managed by both GPO and Intune: GPO and Intune write the same registry keys (HKLM\SOFTWARE\Policies\WinAppack). Configure the WinAppack Agent with only one of them on a given device. Otherwise, each one overwrites the values set by the other and the Agent configuration becomes unpredictable.

How to create a new Policy ?

In the Intune admin center, go to Devices > Manage devices > Configuration > Create > New Policy, then select:

Agent-Intune-Configuration1

Then complete the steps of the wizard:

  1. Basics: enter a name for the profile, for example "WinAppack Agent Configuration". Agent-Intune-Configuration2
  2. Configuration settings: open Computer Configuration > WinAppack v1.1 and set the policies described below. Agent-Intune-Configuration3
  3. Assignments: assign the profile to your devices (see Assign the policy).
  4. Review + create: check the summary and click Create.

PolicyMode

This policy enables or disables management of the WinAppack Agent via GPO. When disabled, all other policies have no effect.

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

To enable management of the WinAppack Agent :

enabled

To disable management of the WinAppack Agent :

disabled

Default Value :

disabled

LicenseKey

Use this policy to activate the WinAppack Agent. Without a license key, all other policies have no effect.

Activate the WinAppack Agent :

Accepted Values : Replace "ABCDEFG123" by your licenseKey

ABCDEFG123

Default Value :

disabled

DesktopShortcut

Manage the "WinAppack.lnk" shortcut on the public desktop :

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

enabled
disabled

Default Value :

enabled

StartMenuShortcut

Manage the "WinAppack.lnk" shortcut in the Start Menu :

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

enabled
disabled

Default Value :

enabled

ManifestUrl

URL of the JSON manifest containing the list of available software :

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

https://otherserver.com/v1/WinAppack-SoftwareList.json

To explicitly use the default URL, set the value to :

disabled

Default Value : https://api.winappack.fr/v1/WinAppack-SoftwareList.json

disabled

DownloadBaseUrl

URL of the site hosting the software logos (.svg / .png) and the PowerShell installation scripts (.ps1) :

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

https://otherserver.com

To explicitly use the default hosting site, set the value to :

disabled

Default Value : https://api.winappack.fr

disabled

RefreshDelayMinutes

Time interval between update checks :

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

60

To explicitly use the default value, set the value to : 60

disabled

Default Value : 60

disabled

CloseAppMessage

Enable or Disable the message asking the user to close the application before installation :

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

enabled
disabled

Default Value :

disabled

DefaultDeployment

Manage the default behavior in the user interface for software that does not have a deployment policy :

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values :

Available : For software that does not have any Deployment policy in the Software configuration, the software will appear as available in the user interface

Available

NotAvailable : For software that does not have any Deployment policy in the Software configuration, the software will not appear in the user interface.

NotAvailable

Default Value : Available

Available

Software Configuration :

To configure the list of authorized software, use the Slug of each software. The full list of available Slugs is on the Software List page (Slug column, with a button to copy each Slug to the clipboard).

Agent-Intune-Configuration4

Deployment Available

Each software present in this policy will be available for installation/uninstallation in the user interface.

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values : Replace {Slug} by one or multiple Software Slug. The list of available Slugs is on the Software List page.

{Slug1}
{Slug2}
{Slug3}

Example :

Audacity
7_zip
Notepad_plus_plus

Default value for each Software : See DefaultDeployment policy value.

Deployment Required

Each software present in this policy will be automatically installed. Users cannot manage the installation or uninstallation of this softwares in the user interface.

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values : Replace {Slug} by one or multiple Software Slug. The list of available Slugs is on the Software List page.

{Slug1}
{Slug2}
{Slug3}

Example :

Audacity
7_zip
Notepad_plus_plus

Default value for each Software : See DefaultDeployment policy value.

Deployment NotAvailable

Each software present in this policy will not be available for installation/uninstallation in the user interface. Users cannot manage the installation or uninstallation of this softwares in the user interface.

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values : Replace {Slug} by one or multiple Software Slug. The list of available Slugs is on the Software List page.

{Slug1}
{Slug2}
{Slug3}

Example :

Audacity
7_zip
Notepad_plus_plus

Default value for each Software : See DefaultDeployment policy value.

Deployment Uninstall

Each software present in this policy will be automatically uninstalled. Users cannot manage the installation or uninstallation of this softwares in the user interface.

Note : This policy requires a valid license key to take effect (see the LicenseKey policy).

Accepted Values : Replace {Slug} by one or multiple Software Slug. The list of available Slugs is on the Software List page.

{Slug1}
{Slug2}
{Slug3}

Example :

Audacity
7_zip
Notepad_plus_plus

Default value for each Software : See DefaultDeployment policy value.

Remark : If a software is present in different Deployment Policies, the Agent applies policies in the following priority order : Uninstall, NotAvailable, Required, Available

Assign the policy

In the Assignments step of the wizard, add the groups that will receive the configuration:

Then go to the Review + create step and click Create.

Verify the configuration

Once a device has received the policy, open the Registry Editor (regedit) on this device and check the following keys:

Each configured policy appears as a registry value. A policy that is not configured does not appear: the Agent then uses its default value.

Regedit-Configuration1 Regedit-Configuration2

If the keys are missing, force a sync from the Intune admin center (Devices > All devices, select the device, then Sync) and check again.