Deployment Wizard Reference

Details the options in the Patch My PC Cloud Deployment Wizard

When deploying an app using Patch My PC (PMPC) Cloud, you have a multitude of options as detailed below.

General Information

The General Information page contains the following options.

Connection

Shows the type of connection. Currently, we only support connections to Intune.

Display Name

The name of the deployment, which should be unique. This is also the name of the app as it will appear on the target devices.

Language

The language version of the app to be deployed.

Architecture

The architecture of the installer to be deployed:

  • 64-bit installers can only be installed on 64-bit devices

  • 32-bit installers can typically be installed on either 32-bit or 64-bit devices.

  • Unspecified installers typically contain install logic for both architectures.

Install Context

The context in which to install the application:

  • System – Available to all users.

  • User – Available only to the specific user.

Installer Type

Choose the installer type for those listed to install this app:

  • .EXE

  • .MSI

  • .MSP

Note

MSP Installers are only able to patch existing installations, whereas MSl and EXE-based installers are typically able to perform a fresh installation or patch an existing installation.

Configurations

The Configurations page contains the following options.

Install Scripts

Scripts that be run as part of the installation process, either before or after the installer.

Note

  • Scripts will be run in the same context as the application.

  • Each install script is limited to 1 MB per script, with a total size limit of 4 MB for all scripts.

  • There is a limit of 50,000 characters per script.

OptionDescription

Pre Install

A script that can be run before the installer. You can either create your own script by typing it directly into the editor or click Import to import an existing script.

Supported file types are:

o .BAT

o .CMD

o .PS1

o .VBS

Post Install

A script that can be run after the installer. You can either create your own script by typing it directly into the editor or click Import to import an existing script.

Supported file types are the same as pre-install scripts.

Uninstall Scripts

Scripts that be run as part of the uninstall process, either before or after the uninstaller.

Note

  • Scripts will be run in the same context as the application.

  • Each install script is limited to 1 MB per script, with a total size limit of 4 MB for all scripts.

  • There is a limit of 50,000 characters per script.

OptionDescription

Pre Uninstall

A script that can be run before the uninstaller. You can either create your own script by typing it directly into the editor or click Import to import an existing script.

Supported file types are:

o .BAT

o .CMD

o .PS1

o .VBS

Post Uninstall

A script that can be run after the uninstaller. You can either create your own script by typing it directly into the editor or click Import to import an existing script.

Supported file types are the same as pre-install scripts.

Install Parameters

OptionDescription

Install Parameter Summary

Shows any default installation parameters.

NOTE: These cannot be modified.

Additional Argument

Allows you to provide any additional arguments to be added to the installation command line.

Desktop Shortcut

OptionDescription

Remove Desktop Shortcut

If checked, will remove the desktop shortcut created as part of the app installation.

Available Uninstall

OptionDescription

Allow Available Uninstall

If checked, allows Intune Apps to uninstall the app if the Company Portal installed it.

Conflicting Process

The installation of some apps cannot be completed if the app:

  • is currently running

  • uses a shared process that needs to be closed, but in doing so, could impact that process and other apps using it.

This setting lets you control what happens in such scenarios, using one of the following options.

OptionDescription

Perform the installation

Performs the installation regardless.

Auto-close conflicting application process before installation

Automatically closes the app/process causing the conflict to allow this app to be installed. IMPORTANT: This can result in data loss so use with care.

Skip installation when conflicting processes are in use

The installation is skipped until the conflicting process is no longer in use.

Notify the user to close the application

The default option. The user sees a notification requesting they close the app that is preventing this install. NOTE: If the user snoozes/defers the update, the installation returns as a failure and retries 24 hours later.

Conflicting Process - Settings

Allows you to configure the following Advanced Settings for Conflicting Processes.

Notify Timeout Configuration

How long in seconds (300 by default), before the notification timeouts.

Notification Policy

OptionDescription

Notification behavior if the application running and focus assist is enabled

How the notification behaves if the app is currently running and Focus Assist is enabled: o Discard the Notification (default) o Always show the notification o Show the notification if the deferred policy is reached

Do not allow user deferral

The user cannot defer the installation. The app will close and update when the timeout expires.

Allow the user to defer the installation

Controls both: o How many times the user can defer the installation. o What happens if the timeout expires and the user hasn't taken an action.

Prevent the application from being opened while it is updating

Prevents the app from opening whilst it is being updated.

Conflicting Process - Conflicting Process

Clicking the Conflicting Process button lets you see any conflicting processes we have identified that will prevent an app from updating.

You can also add additional entries or remove existing entries to suit your environment.

Assignments

The Assignments page contains the following options.

Note

As our portal uses application permissions to read EntraID groups, all groups will be visible whenever you manage assignments.

Add Assignment

OptionDescription

Add Available

The app will appear in your Company Portal for the primary user of the device.

Add Required

This is a required deployment so the app will be installed automatically.

Add Update Only

Only install updates to an existing app that has already been installed. This option does not install the app or any updates to it on a device where the app has never been previously installed.

Add Uninstall

The apps uninstaller will be deployed.

Add <assignment_type> Assignment

The Add <assignment_type> Assignment screen displays your existing Entra ID groups that can be used for targeting.

OptionDescription

Include

If checked, all of the items in this group will receive the assigned app.

Exclude

If checked, all of the items in this group will not receive the assigned app. Can be used in conjunction with Include to exclude a subset of devices when you have an Include of a superset of devices. For example, you want to target all of your computers except for your test devices. To achieve this, you'd configure your Entra ID groups as follows: o Check Include for your All Company Devices Entra ID group. o Check Exclude for your Test Devices Entra ID group.

Assignment "Summary"

Once at least one assignment has been added using the Add Assignment button, a summary of the assignments configured for the assignment is shown on the Assignments tab. At this point, you can make the following optional modifications to the assignment(s).

OptionDescription

Add Filter

The ability to add filters to target specific device types for the deployment.

Notifications

When to display notifications related to this deployment.

Content Download

How to download the content for the deployment: o Foreground - The default for initial installs. o Background - The default for updates.

Summary

As the Summary page contains items from previous pages, its details are not documented.

Note

If you have any feedback or comments on our docs, please email docs@patchmypc.com.

Last updated