Custom Apps "File" tab

Applies to: Patch My PC Cloud Custom Apps

The File tab of the Patch My PC (PMPC) Cloud Custom Apps Deployment wizard lets you configure various settings for the Custom App you are creating.

To configure the File tab:

1. Select the relevant type of installer for this Custom App:

   1. Installer File – Select this option (selected by default) if the installation will be based on an installer file. Proceed to the Add the Primary Install File section.

   2. Installation Script – If the installation will be controlled based on a script, select this item and proceed to the Add the Installation Script section.

Important

The Installer Type feature is a pre-release feature still under development and, therefore, incomplete. As a result, both functionality and documentation are subject to change.

Once this feature is released, it will be announced, and this banner will be removed.

Also, changing the Installer Type will reset all of the settings in the Custom Apps Deployment Wizard.

Note

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

Also, we currently support the following script types:

• .BAT

• .CMD

• .PS1

• .VBS

Important

Currently, Pre and Post scripts containing "${env:ProgramFiles(x86)}" or "${env:ProgramFiles}" cannot be uploaded as Cloudflare is falsely identifying them as a false positive related to Log4j exploits. We are actively working with them to resolve this, but as this is outside our control, we cannot provide an estimated resolution time.

To work around this issue, see the Resolution section of "TypeError: Failed to fetch" error when trying to upload a Pre or Post Script.

Add the Primary Install File

To add the primary installer for a Custom App:

1. On the File page, either:

   1. Click Add Primary Install File and browse to the location containing the app’s installer (EXE or MSI).

   2. Drag and drop the installer file onto this page.

Important

We do not support macOS in Custom Apps. If you select a .pkg/.dmg you will see a warning stating this and explaining how you can upvote this idea.

Tip

If you plan to deploy an EXE-based installer, use our free script to help you extract the required information from the registry. See Finding properties for EXE-Based Installers for more information.

The hash for the file is calculated as it is uploaded to your Cloud Portal and will appear as completed once the upload has finished.

1. If the installer does not require any additional folders or files, click Next to go to the General Information tab. If the installer does require additional folders or files, go to Add Extra Folders and Files .

Add the Installation Script

To use an installation script to install the app, from the Script section, choose how you are going to add the script:

• Import a Script

• Add a Script Manually

Import a Script

To import an existing script:

1. Click Import Script and browse to the location containing the script and select

The App Installation Script editor appears with the Script Name and Script Format fields automatically populated, and the script editor is populated with the imported script.

Note

If the script you are importing contains PSADT commands, we automatically detect this and update the Script Format to PowerShell + PSADT.

Also, as the warning at the bottom of the script editor tells you, we do not sign scripts. If you want this script to be signed, click the How to sign a script link for a walkthrough.

1. Click Save to save the script and return to the File tab, where details of the script appear under the Script section.

Important

If the script you imported contains PSADT commands, you will see the following warning under the Script section :

PSADT functions were detected. Please ensure .NET Framework 4.7.2 or greater is installed on your device.

As the warning states, you should ensure that .NET Framework 4.7.2 (or later) is installed on any devices to which this app will be deployed, so that it installs and functions correctly.

Tip

You can edit the script by clicking the pencil icon or delete it by clicking the trash can.

1. If the installer does not require any additional folders or files, click Next to go to the General Information tab. If the installer does require additional folders or files, go to Add Extra Folders and Files.

Add a Script Manually

To manually add a script:

1. Click Add Manually

The App Installation Script editor appears, prefilled with some values.

1. If required, change the:

   1. Name of the script in the Script Name field.

   2. Type of script from the Script Format dropdown.

Tip

You can also click Import to import an existing script.

1. In the script editor, type your script, then click Save

Note

If the enter any PSADT commands in the script editor, we automatically detect this and update the Script Format to PowerShell + PSADT.

Also, as the warning at the bottom of the script editor tells you, we do not sign scripts. If you want this script to be signed, click the How to sign a script link for a walkthrough.

Tip

You can also click Export to export this script to an external file.

The File tab is redisplayed, showing details of the script under the Script section.

Important

If your script contains PSADT commands, you will see the following warning under the Script section :

PSADT functions were detected. Please ensure .NET Framework 4.7.2 or greater is installed on your device.

As the warning states, you should ensure that .NET Framework 4.7.2 (or later) is installed on any devices to which this app will be deployed, so that it installs and functions correctly.

Tip

You can edit the script by clicking the pencil icon or delete it by clicking the trash can.

1. If the installer does not require any additional folders or files, click Next to go to the General Information tab. If the installer does require additional folders or files, go to Add Extra Folders and Files.

Add Extra Folders and Files

Note

Configuring Extra Folders and Files is optional, and the process is the same regardless of the Installer Type selected.

If the installer requires additional folders or files, either:

1. Click Add Folder or Add Files and browse to the location containing the additional folders/files OR

   Drag and drop the folders/files onto this page.

Important

If you add any PSADT scripts to your Custom App, you need to ensure that .NET version 4.7.2 is installed on any devices to which this Custom App is deployed.

1. Click Next to move to the General Information tab.