Software Distribution in Workspace ONE UEM allows you to deliver Windows applications and adhere to the application life-cycle. Software Distribution enables your organization to deploy applications, track the installation statuses, debug and troubleshoot installation issues, and maintain applications with ease.You can upload Win32 applications as either main files or dependency files. You can use the same process for EXE, MSI, and ZIP files. If you are using a ZIP file, you can compress the application packages that are 4GB or larger using 7-Zip. Workspace ONE UEM does not decompress ZIP packages containing application packages of 4GB or larger when compressed using the native Windows zip compressor.Software Distribution engine (SFD) requires an MSI file or an EXE file inside the ZIP file to deploy a PowerShell script file.

Complete the following steps to upload Win32 Files for Software Distribution:

Procedure

  1. Navigate to Resources > Apps > Native > Internal and select Add Application.
  2. Select Upload.
  3. Select Local File and select the application to upload.
  4. Select an answer to Is this a dependency file.
    • Select Yes to tag a dependency file and associate it to Win32 applications. Examples of dependency files are libraries and frameworks.

    • Select Continue to go to the next phase in the life cycle.

  5. Configure the Details tab options.

    Workspace ONE UEM 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 later, 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.

    Update Notifications

    Enable this to get notifications when a new version of an existing app in your catalog becomes available.

    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.

  6. 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. SelectFile 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.

  7. 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. Select Data 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.

      Use a comparison operator to specifically target an app version or to target a range of app versions.

      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.

      Use a comparison operator to target a specific file version or a range of file versions.

      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 value is or is not on devices.

      • Completion – Configure the system to identify the installation is complete when a specific registry value 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 that corresponds to the registry value.

      • Value Data - Enter the value of the key.

        You can use comparison operators to target registry values by date and time. However, you must use the ISO Date and Time standard. Access information about the standard, ISO 8601, on the W3C (W3 Consortium) website at Date and Time Formats. Here is an example of targeting registgries exsisting before 10 am Eastern Standard Time on December 31, 2020.

    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.
  8. 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.

    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.

    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.

  9. 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.

      Use a comparison operator to specifically target an app version or to target a range of app versions.

      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.

      Use a comparison operator to target a specific file version or a range of file versions.

      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 value is or is not on devices.

      • Completion – Configure the system to identify the installation is complete when a specific registry value 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.

      • Value Type-Select the type that corresponds to the registry value.

      • Value Data - Enter the value of the key.

        You can use comparison operators to target registry values by date and time. However, you must use the ISO Date and Time standard. Access information about the standard, ISO 8601, on the W3C (W3 Consortium) website at Date and Time Formats. Here is an example of targeting registgries exsisting before 10 am Eastern Standard Time on December 31, 2020.

      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.

      For example, you can run a script such as powershell -executionpolicy bypass -file script.ps1

      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 be removed from all the systems where it is deployed. Be cautious while editing the Call Installation Complete criteria.

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

What to do next

  • You can now monitor your Win32 applications deployed through software distribution with the statistics on the Details View and by reviewing installation status codes. View the reasons in the Details View to track the progression of an installation. The reason codes help identify the status of an installation and if there is an issue with an installation, so that you can easily track and troubleshoot application deployments.

  • You can remove Win3 applications from your devices. Workspace ONE UEM includes several methods to remove Win32 applications from your devices. Choose from deleting, the application, devices, organization group, assignment group, or user. Several admin functions impact multiple assets. It is important for you to understand the impact before making any changes.

    Table 1. Win32 Application Deletion Methods

    Deletion Method

    Description

    Details View

    Select the Delete Application function in the details view of the application.

    This action removes the Win32 application off devices in smart groups assigned to the application.

    Device

    Delete the applicable device from the console.

    Organization Group

    Delete the organization group.

    This action impacts all assets and devices in the organization group.

    Assignment Group

    Delete the smart or user group assigned to the Win32 application.

    This action impacts every device in the group.

    User

    Delete the applicable user account from the console.