Configure details about the Win32 application, which include to define when to install it, how to install it, and when to identify the installation is complete.

Procedure

  1. Configure the Details tab options.

    The Workspace ONE UEM system cannot parse data from an EXE or ZIP file. Enter the information for the EXE and ZIP files on this tab. The system parses the listed information for MSI files.

    Details Setting Details Description
    Name Enter a name for the application.
    Managed By View the organization group (OG) that the application belongs to in your Workspace ONE UEM OG hierarchy.
    Application ID Represents the application with a unique string. This option is pre-populated and was created with the application.

    Workspace ONE UEM uses the string to identify the application in systems like application whitelists and blacklists.

    Actual File Version If you are using Workspace ONE UEM console 2005 or above, you can enter the actual file version of the application.

    If you are using a Workspace ONE UEM console version prior to 2005, the version number displays the coded version of the application set by the application's developer. When you add an application version, the version field appears as read only for the newer version that is added.

    Build Version Displays an alternate "File Version" for some applications.

    This entry ensures Workspace ONE UEM records all version numbers coded for applications because developers have two places within some applications they can code a version number.

    Version If you are using Workspace ONE UEMconsole 2005 or above, you can enter the actual file version of the application.
    Note:
    • If you want the existing applications in the Workspace ONE UEM catalog to display version information that is consistent with the version you are deploying, you must create a new application in the catalog and provide the appropriate actual version information, and then choose to retire the existing application.
    • You can edit the application version only when you initially upload the zip or exe file. Once you save, the application version is not editable unless you add a new application version.

    If you are using a Workspace ONE UEM console version prior to 2005, the version number displays the internal version of the application set by the Workspace ONE UEMconsole.

    Supported Processor Architecture Select the bit-architecture value for applicable Windows applications.
    Is Beta Tags the application as still under development and testing, a BETA version.
    Change Log Enter notes in this text box to provide comments and notes to other admins concerning the application.
    Categories Provide a category type in the text box to help identify how the application can help users.

    You can configure custom application categories or keep the application's pre-coded category.

    Minimum OS Select the oldest OS that you want to run this application.
    Supported Models Select all the models that you want to run this application.
    Default Scheme Indicates the URL scheme for supported applications. The application is packaged with the scheme, so Workspace ONE UEM parses the scheme and displays the value in this field.

    A default scheme offers many integration features for your internal applications, including but not limited to the following options:

    • Use the scheme to integrate with other platform and web applications.
    • Use the scheme to receive messages from other applications and to initiate specific requests.
    • Use the scheme to start Apple iOS applications in the AirWatch Container.
    Description Describe the purpose of the application.

    Do not use '<' + String in the Description, as you might encounter an Invalid HTML content error.

    Keywords Enter words that might describe features or uses for the application. These entries are like tags and are specific to your organization.
    URL Enter the URL from where you can download the application and get information about it.
    Support Email Enter an email to receive suggestions, comments, or issues concerning the application.
    Support Phone Enter a number to receive suggestions, comments, or issues concerning the application.
    Internal ID Enter an identification string, if one exists, that the organization uses to catalog or manage the application.
    Copyright Enter the publication date for the application.
  2. Complete the Files tab options by uploading dependencies, transforms, patches, and uninstallation processes.
    File Description

    Configurations

    App Dependencies

    MSI, EXE, ZIP

    The environment and devices need these applications to run the Win32 application.
    1. Select dependency files in the Select Dependent Applications option.
    2. Enable the system to apply dependencies in a specified order. The system works from top to bottom.
    App Transforms

    MST file type

    These files control the installation of the application and can add or prevent components, configurations, and processes during the process. Select Add to browse to the MST file on the network.
    App Patches

    MSP file type

    These files add changes that are fixes, updates, or new features to applications. The two types are additive and cumulative.
    • Additive – Includes only changes developed after the latest version of the application or the last additive patch.
    • Cumulative – Includes the entire application including any changes since the latest version of the application or the last patches.
    1. Select Add.
    2. Identify the patch as cumulative or additive.
    3. Select File to browse to the MSP file on the network.
    App Uninstall Process These scripts instruct the system to uninstall an application under specific circumstances.

    Customized scripts are optional for MSI files.

    1. Select the Use Custom Script option.
    2. Select to upload or enter a script to the system for Custom Script Type.
      • Select Upload and browse to the script file on the network.
      • Select Input and enter the custom script.
  3. Complete the settings in Deployment Options > When To Install.
    This tab instructs the system to install the application with specific criteria. The system can parse information for MSI files. However, for EXE and ZIP files, the system requires you to enter this information.
    1. SelectData Contingecies > Add and complete the options that depend on the criteria type you select.
      Set contingencies for instruction and completion scenarios.
      • Instruction – Contingencies instruct the system to install applications when the device meets specific criteria.
      • Completion – Contingencies identify when an installation is complete.
      Setting - App Description - App
      Criteria Type

      App exists

      App does not exist

      • Instruction – Configure the system to install the application when a specific application is or is not on devices.
      • Completion – Configure the system to identify the installation is complete when a specific application is or is not on devices.

      Workspace ONE UEM checks for the existence of the application but it does not deploy the application to devices.

      Application Identifier Enter the application identifier so the system can recognize the existence or non-existence of the auxiliary application.

      This value is also known as the product code of the application.

      Version Enter the specific version.
      Setting - File Description - File
      Criteria Type

      File exists

      File does not exist

      • Instruction – Configure the system to install the application when a specific file is or is not on devices.
      • Completion – Configure the system to identify the installation is complete when a specific file is or is not on devices.
      Path Enter the path on the device where you want the system to look for the file and include the filename.
      Version Enter the specific version.
      Modified On Enter the date the file was last modified.
      Setting - Registry Description - Registry
      Criteria Type

      Registry exists

      Registry does not exist

      • Instruction – Configure the system to install the application when a specific registry is or is not on devices.
      • Completion – Configure the system to identify the installation is complete when a specific registry is or is not on devices.
      Path Enter the path on the device where the system can find the keys and values. Include the entire path, beginning with HKLM\ or HKCU\.
      Configure Registry Values
      • Value Name- Enter the name of the key. This container object stores the value and it displays in the file structure of the device.
      • Valut Type- Select the type of key displayed in the file structure of the device.
      • Value Data - Enter the value of key. The name-data pairs stored in the key display in the file structure of the device.
    2. Set the disk space devices must have available for the system to install the application for Disk Space Required.
    3. Set the battery power devices must have available for the system to install the application for Device Power Required.
    4. Set the random access memory devices must have available for the system to install the application for RAM Required.
  4. Complete the settings in Deployment Options > How To Install.
    Define the installation behavior on devices. While configuring the Win32 applications in the Workspace ONE UEM console, you have different combinations that you can select while setting the Install Context and Admin Privileges under the Deployment tab. Your installation process might vary based on the settings. To understand more about Win 32 application installation behavior, see Win 32 Application Installation Behavior.
    Setting Description
    Install Context Select how the system applies the installation.
    • Device- Define the installation by the device and all the users of that device.
    • User- Define the installation by particular user accounts (enrolled).
    Install Command Enter a command to control the installation of the application.
    • MSI- The system automatically populates the installation commands, and the commands include patches and transforms.
      • Patches- To update the order in which the patches install on devices, update their listed order in the install command.
      • Transforms- The order in which the system applies transforms is set when you assign the application. You see a placeholder name for the transform until you associate the transform during the assignment process.
    • EXE and ZIP- Populate the install command and specify the patch names and their order of application in the command. You must also enter the install command that triggers the installation of the Win32 application.

      If you do not package the patches and transforms in the EXE or ZIP file and you add them separately, ensure to add the patch filenames and the transform lookup text boxes in the install command.

    Admin Privileges Set the installation to bypass admin privilege requirements.
    Device Restart The values for Device Restart options for Win32 applications allow the user to defer the device reboot for "x" days with a maximum limit of 7 days. The values allow admins to have a much better control over the application management lifecycle. Admins can choose to force restart applications or create application restarts that require the user engagement and provides a friendly user experience while installing the admin mandated applications.

    By default, Device Restart is set to User engaged Restart that allows you to configure the Restart Deadline for each application. To set the Restart Deadline, enter the deadline date. You can also choose Do Not Restart or Force Restart options if you choose not to the restart or force the device restart.
    Note: Restart deadline has a maximum limit of 7 days.

    For more information, see Considerations for Device Restart for your Win32 Applications.

    Retry Count Enter the number of times the system attempts to install the application after an unsuccessful attempt.
    Retry Interval Enter the time, in minutes, the system waits when it tries to install the application after an unsuccessful attempt.
    Install Timeout Enter the maximum time, in minutes, the system allows the installation process to run without success.
    Installer Reboot Exit Code Enter the code the installer outputs to identify a reboot action.

    Review the entry for Device Restart. If you selected to Do not restart but you enter a reboot exit code, the system considers the installation a success after the reboot completes even though the Device Restart settings do not require a restart for success.

    Installer Success Exit Code Enter the code the installer outputs to identify a successful installation.
  5. Complete the settings in Deployment Options > When To Call Install Complete.
    Configure Workspace ONE UEM to identify the successful installation of Win32 applications. The system requires this information for EXE and ZIP files.
    1. Configure the system to use specific criteria to recognize the completion of the installation process for Use Additional Criteria.
    2. To identify the installation completion or use custom scripts, add a specific criteria for Identify Application By.
      Setting - Defining Criteria - App Description - Defining Criteria - App
      Criteria Type

      App exists

      App does not exist

      • Instruction – Configure the system to install the application when a specific application is or is not on devices.
      • Completion – Configure the system to identify the installation is complete when a specific application is or is not on devices.

      Workspace ONE UEM checks for the existence of the application but it does not deploy the application to devices.

      Application Identifier Enter the application identifier so the system can recognize the existence or non-existence of the auxiliary application.

      This value is also known as the product code of the application.

      Version Enter the specific version.
      Setting - Defining Criteria - File Description - Defining Criteria - File
      Criteria Type

      File exists

      File does not exist

      • Instruction – Configure the system to install the application when a specific file is or is not on devices.
      • Completion – Configure the system to identify the installation is complete when a specific file is or is not on devices.
      Path Enter the path on the device where you want the system to look for the file and include the filename.
      Version Enter the specific version.
      Modified On Enter the date the file was last modified.
      Setting - Defining Criteria - Registry Description - Defining Criteria - Registry
      Criteria Type

      Registry exists

      Registry does not exist

      • Instruction – Configure the system to install the application when a specific registry is or is not on devices.
      • Completion – Configure the system to identify the installation is complete when a specific registry is or is not on devices.
      Path Enter the path on the device where the system can find the keys and values. Include the entire path, beginning with HKLM\ or HKCU\.
      Configure Registry Values
      • Value Name- Enter the name of the key. This container object stores the value and it displays in the file structure of the device.
      • Valut Type- Select the type of key displayed in the file structure of the device.
      • Value Data - Enter the value of key. The name-data pairs stored in the key display in the file structure of the device.
      Setting - Using Custom Script Description - Using Custom Script
      Script Type Select the type of script.
      Command to Run the Script Enter the value that triggers the script.Custom Script Type.
      Custom Script File Select Upload and navigate to the custom script file on the network.
      Success Exit Enter the code that the script outputs to identify the successful installation.
      Note:

      If you are required to edit the When to Call Installation Complete criteria after an app has been deployed, select the Edit button in this section. Enter the Admin PIN to complete the action. If you change the criteria to a value that is invalid, the app will bez removed from all the systems where ii is deployed. Be cautious while editing the Call Installation Complete criteria.

  6. Select Save & Assign to configure flexible deployment options.

What to do next

Assign flexible deployment schedules to the Win32 application. See Add Assignments and Exclusions to ApplicationsVMware Workspace ONE UEM 1904.