The VMware Workspace ONE Provisioning tool allows you to test your Dell Provisioning for VMware Workspace ONE configuration files. The tool also allows you configure the tool settings and use command line actions to run tests.

Command Line Actions

You can choose to run your tests using command line actions.

Table 1. VMware Workspace ONE Provisioning Tool Command Line Actions

Command Line Action

Description

-a, --action

Required. Action to perform (AppsOnly or Full).

-p, --ppkg

Required. PPKG File path.

-u, --unattend

Unattend XML File path.

-s, --shutdown

Shuts down the computer after the Sysprep command finishes running.

-r, --reboot

Restarts the computer after Sysprep. You can use this option to audit the computer and to verify that the first-run experience operates correctly. The tool reboots by default if no option is specified.

--help

Display the help screen.

--version

Display the version information.

After running the action, exit codes display. These codes report the outcome of the action. The exit codes are as follows:

  • 0 - Success

  • 1 - Failure

  • 2 - Reboot Required

  • 3 - Timeout

Some examples include:

  • Display the help screen: VMwareWS1ProvisioningTool --help

  • Apply apps only (PPKG): VMwareWS1ProvisioningTool -a appsonly -p 'C:\MyProvisioningPackage.ppkg'

  • Apply full process (ppkg & XML) - shutting down the system at the end: VMwareWS1ProvisioningTool -a full -p 'C:\MyProvisioningPackage.ppkg' -u 'C:\MyAnswer.xml' -s

  • Apply full process (ppkg & XML) - rebooting the system at the end: VMwareWS1ProvisioningTool -a full -p 'C:\MyProvisioningPackage.ppkg' -u 'C:\MyAnswer.xml' -r

VMware Workspace ONE Provisioning Tool Configuration Options

You can change the configuration settings for the VMware Workspace ONE Provisioning Tool to meet your needs. To change the settings, you must edit the VMwareWS1ProvisioningTool.exe.config file.

The config file contains the settings that control how the VMware Workspace ONE Provisioning Tool runs. Here are some commonly used settings for consideration. More settings are found in the config file. Consider reviewing the following settings to best meet your needs.

Table 2. VMware Workspace ONE Provisioning Tool Configuration Settings

Setting

Description

loggingConfiguration

Enter the file path, logging level, file size, and maximum number of archived files.

The level= value controls the log level. The default value is "Information". For troubleshooting, consider changing the level to "Verbose".

"TimeoutMinutes"

Enter a value, in minutes, for how long the tool should attempt to apply the PPKG before timing out. Consider keeping this value below 90 minutes.

"RefreshRateSeconds"

Enter a value, in seconds, for how frequently the tool refreshes the installation progress of the PPKG.

"BitLockerDecryptionTimeoutMinutes"

Enter a value, in minutes, for how long the tool should wait for BitLocker Decryption to finish before timing out.

"UnattendXmlCleanup"

Set to True to remove the Unattended XML file after the configuration process finishes.

Reading the PPKG Final Summary Log

After the VMware Workspace ONE Provisioning Tool finishes applying the PPKG to the device, a summary log generates. You can find the logs in C:\ProgramData\Airwatch\UnifiedAgent\Logs\PPKGFinalSummary.log. These logs are useful for troubleshooting. Dell may ask for these logs if there are issues provisioning devices.

The logs cover important information such as the OS details, client network details, and PPKG details. You can also see a log of the status updates that displayed in the tool during processing.