The VMware Workspace ONE Provisioning Tool allows you to test your Workspace ONE Drop Ship Provisioning (Offline) configuration files, to configure the tool settings, and to use command-line actions to run tests. You can also collect logs to help troubleshoot tool issues.
You can choose to run your tests using command-line actions.
|-a, --action||Required. Action to perform (AppsOnly, Full, or TrackOnly).|
|-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.|
|-q, --quit||Closes the Sysprep tool without rebooting or shutting down the device after Sysprep finishes running the commands.|
|-g, --gui||Run the application with GUI.
The default is
|-l, --autologin||Enable auto login after reboot.
The default is
|-n, --username||User name for auto login.|
|-w, --password||Password for auto login.|
|--help||Display the help screen.|
|--version||Display the version information.|
- 0 - Success
- 1 - Failure
- 2 - Reboot Required
- 3 - Timeout
- Display the help screen:
- 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
- Track only the application queue with GUI:
VMwareWS1ProvisioningTool -a trackonly --gui
- Track the application queue with GUI with the auto login enabled:
VMwareWS1ProvisioningTool -a trackonly --gui --autologin -n myuser -w mypassword
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.
||Enter the file path, logging level, file size, and maximum number of archived files.
||Enter a value, in minutes, for how long the tool can attempt to apply the PPKG before timing out. Consider keeping this value below 90 minutes.|
||Enter a value, in seconds, for how frequently the tool refreshes the installation progress of the PPKG.|
||Enter a value, in minutes, for how long the tool can wait for BitLocker Decryption to finish before timing out.|
||Set to True to remove the source Unattended XML file from the system drive after staging the device. If the Unattended XML is not present on the device, the file is only copied.|
||Set to true to delete all PPKG files in the specified cleanup file path.|
||Enter the file path to clean up any PPKG after staging. Any file with the PPKG extension is deleted.|
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. If there are issues provisioning devices, Dell might ask for these logs.
The logs cover important information such as the OS details, client network details, device model and manufacturer, and PPKG details. If you do not set the device into audit mode, a note is made in the log to help troubleshoot why the process failed. You can also see a log of the status updates that displayed in the tool during processing.
Logs for Troubleshooting Failures
The VMware Workspace ONE Provisioning Tool collects information after a tool failure. The tool collects logs and stores them to the machine user's Diagnostics folder in Users\<username>\AppData\Local\Temp\Diagnostics.
- ZIP of the Logs folder that includes the PPKGFinalSummary.log file found on the machine in C:\ProgramData\Airwatch\UnifiedAgent\Logs.
- ZIP of the AwProvAgent folder found on the machine in C:\ProgramData\AwProvAgent.
- ZIP of the VMware folder found on the machine in C:\ProgramData\VMware.
- ZIP of the Support folder found on the machine in C:\ProgramData\AirWatchMDM\Support.
- The AirWatchMDM.tmf file found on the machine in C:\ProgramData\AirWatchMDM\Support\WINDIR\system32\AirWatchMDM.tmf.
- The AirWatch event file found in the viewer in .
- The Provisioning Service event file found in the viewer in .
- The Device Management event file found in the viewer in .