Deploying Commercial Vantage with Intune

For those who are migrating from Configuration Manager to Intune, you may find the need to deploy Commercial Vantage to your devices from Intune. Commercial Vantage consists of a UWP app plus other services and components. An enterprise package with deployment guide and ADMX templates is available to assist deploying this solution. Download the latest version of Commercial Vantage with Deployment Guide here.

Preparing the Win32 App

Once the zip has been downloaded and extracted, use the Content Prep Tool to convert to an .intunewin format. There is already a provided batch file that handles the installation of all dependencies, certs, and .msix bundle so this will be used as the setup file. A sample command would be:

IntuneWinAppUtil.exe -c "C:\IntuneWin\LenovoCommercialVantage_10.2010.11.0_v1" -s "setup-commercial-vantage.bat" -o "C:\IntuneWin\output" -q

Creating the Win32 App

Login to the MEM admin center and add a new Windows app (Win32). Select the new App package file created above, which should be named setup-commercial-vantage.intunewin and click OK.

Fill out the necessary fields in the App information section and click Review + save

In the Edit application section, this is where the install/uninstall commands will be specified.

• Install command

setup-commercial-vantage.bat

• Uninstall command

C:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -ExecutionPolicy Bypass -File .\uninstall_vantage_v8\uninstall_all.ps1

Set Device restart behavior to Determine behavior based on return codes.

In the Requirements section, set the Operating system architecture to 64-bit and Minimum operating system to 1809

Add an additional Registry type requirement rule that will only apply to Lenovo branded systems.

• Key path

HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\BIOS

• Value name

SystemManufacturer

• Registry key requirement: String comparison

• Operator: Equals

• Value

LENOVO

For the detection rule, a custom script detection will be used. Commercial Vantage depends on these 2 services to run

• ImControllerService (Not required for ARM-based devices)
• LenovoVantageService

This sample PowerShell script can be used for detection

Info

If the Store is not blocked in your environment, Vantage will automatically update itself as new versions are released.

# Version of Lenovo Vantage that is being deployed
$DeployedVantageVersion = [version]"10.2407.66.0"

try
{
    # Get the processor architecture (0 = x86, 9 = x64, 12 = ARM64, etc.)
    $processorArch = (Get-CimInstance -Namespace root/cimv2 -ClassName Win32_Processor -ErrorAction Stop).Architecture

    if ($processorArch -eq 12)
    {
        Write-Output "ARM64 architecture detected. Skipping Im Controller check."
    }
    else
    {
        # Check for the ImControllerService
        try
        {
            $imControllerService = Get-Service -Name ImControllerService -ErrorAction Stop
        }
        catch
        {
            Write-Output "ImControllerService not found or not running."
            exit 1
        }
    }

    # Check for the Lenovo Vantage Service and ensure it is not an outdated version
    try
    {
        # Get the path to the most recent VantageService folder under ProgramFiles(x86)
        $vantageServicePath = Get-ChildItem -Path "${env:ProgramFiles(x86)}\Lenovo\VantageService" -Directory | Select-Object -Last 1

        # Check if the path exists before proceeding
        if ($vantageServicePath)
        {
            # Find LenovoVantageService.exe in the directory
            $vantageServiceFile = Get-ChildItem -Path $vantageServicePath.FullName -Filter "LenovoVantageService.exe" -File -Recurse -ErrorAction Stop | Select-Object -Last 1

            if ($vantageServiceFile)
            {
                # Extract the version information
                $serviceVersion = [version]$vantageServiceFile.VersionInfo.FileVersion
            }
            else
            {
                $serviceVersion = $null
                Write-Warning "LenovoVantageService.exe was not found."
            }
        }
        else
        {
            $serviceVersion = $null
            Write-Warning "VantageService directory was not found."
        }

        $minServiceVersion = [version]"3.8.23.0"
        if ($serviceVersion -le $minServiceVersion)
        {
            Write-Output "Lenovo Vantage Service is outdated (found version $serviceVersion, required minimum $minServiceVersion)."
            exit 1
        }
    }
    catch
    {
        Write-Output "Failed to retrieve Lenovo Vantage Service version. Error: $($_.Exception.Message)"
        exit 1
    }

    # Check for the Lenovo Commercial Vantage APPX package
    try
    {
        $vantagePackage = Get-AppxPackage -Name E046963F.LenovoSettingsforEnterprise -AllUsers -ErrorAction Stop
        $installedVersion = [version]$vantagePackage.Version

        if ($installedVersion -ge $DeployedVantageVersion)
        {
            Write-Output "Lenovo Commercial Vantage APPX package is up-to-date (installed version: $installedVersion, required version: $DeployedVantageVersion)."
            exit 0
        }
        else
        {
            Write-Output "Lenovo Commercial Vantage APPX package is outdated (installed version: $installedVersion, required version: $DeployedVantageVersion)."
            exit 1
        }
    }
    catch
    {
        Write-Output "Failed to detect Lenovo Commercial Vantage APPX package. Error: $($_.Exception.Message)"
        exit 1
    }
}
catch
{
    Write-Output "An unexpected error occurred. Error: $($_.Exception.Message)"
    exit 1
}

Click Review and then Save to complete the app creation and content upload to Intune. Once the upload has finished, assign to a group.

Automatically Create the Win32 App

A PowerShell helper script can be used to automatically create the Win32 app using the IntuneWin32App module.

Download the New-CommercialVantageWin32.ps1 and Detect-CommercialVantage.ps1 from my GitHub here.

Results

Track the installation through the IntuneManagementExtension.log

Here we can see the minimum OS version requirement has been met

The additional requirement to check if the system is in fact a Lenovo system is true

Monitoring the AgentExecutor.log, the detection script returns Commercial Vantage is up-to-date