Note

You are not reading the most recent version of this documentation. See the latest version available.

Quality Approver CLI

Command line options of Quality Approver allows to automate testing of MSI, MSIX and APPX packages.

Warning

Ensure that you have configured at least one virtual machine for the testing purposes. To configure a VM, see Configuration of testing environment.

Syntax:

"QualityApprover.exe" <command> [--parameter "value"]

Usage:

"QualityApprover.exe" test-msi --vm "172.16.1.100;WIN10_1809_EN" --package "C:\Packages\package.msi" --output-report "C:\Reports\report.html"

The default installation path of QualityApprover.exe is:

• x64 OS: C:\Program Files (x86)\PACE Suite\Quality Approver\App\

• x86 OS: C:\Program Files\PACE Suite\Quality Approver\App\

Commands:

Command	Description
test-msi	Test a batch of Windows Installer (MSI, MST) packages and their apps for compliance with the Desktop App Certification Program automatically in an unattended mode. For more information, see Windows Desktop app tests. See parameters of the Test MSI command.
test-msix	Test a batch of MSIX packages (or bundles) and their apps against the Microsoft Store requirements automatically in an unattended mode. For more information on the tests, see Windows Store App tests and Windows Desktop Bridge app tests. See parameters of the Test MSIX/APPX command.
test-appx	Test a batch of APPX packages (or bundles) and their apps against the Microsoft Store requirements automatically in an unattended mode. For more information on the tests, see Windows Store App tests and Windows Desktop Bridge app tests. See parameters of the Test MSIX/APPX command.

Test MSI

Parameters of the test-msi command:

Parameter	Obligatoriness	Description
--vm	Mandatory	Defines a virtual machine on which the package will be tested. Supported value: "localhost" - run testing on the local host "<host_addres>;<vm_name>" - run testing on the remote virtual machine where <host_addres> is a host or IP address of the virtualization solution (for VirtualBox <host_addres> is virtualbox); and <vm_name> is a name of a virtual machine, configured for testing. Example: --vm "172.16.1.100;WIN10_1809_EN"; --vm "virtualbox;WIN10_1809_EN"
--package	Mandatory	Defines a path to the package that will be tested. Example: --package "C:\Packages\package.msi"
--apply-mst	Optional	Defines a path to the MST file that will be applied to the specified MSI during testing. If not defined, no additional MST is applied. Example: --apply-mst "C:\Packages\transform.mst"
--app-usage-type	Optional	Defines a usage type of the application that will be installed by the MSI package. If not specified, the per-machine type is used. Supported values: "per-machine" "per-user" Example: --app-usage-type "per-machine"
--copy-related-files	Optional	Defines what package-related files that are located in the same folder with MSI should be copied to the remote virtual machine for testing. If not specified, none of additional files will be copied. Supported values: "*" - copy all files/subfolders located in the folder with MSI "<file-path-1;file-path-2>" - copy the specified files only. A path could be absolute or relative. Example: --copy-related-files "Folder A;File B.ext;File C.ext"
--output-report	Mandatory	Defines a path and a name of the testing report. Example: --output-report "C:\Reports\report.html"
--vm-restore	Optional	Defines if the virtual machine will be restored to the previous state after the testing completion. If not specified, the virtual machine will be restored. Supported values: "yes" - restore "no" - do not restore Example: --vm-restore "no"

Test MSIX/APPX

Parameters of the test-msix and test-appx commands:

Parameter	Obligatoriness	Description
--vm	Mandatory	Defines a virtual machine on which the package will be tested. Supported value: "localhost" - run testing on the local host "<host_addres>;<vm_name>" - run testing on the remote virtual machine where <host_addres> is a host or IP address of the virtualization solution (for VirtualBox <host_addres> is virtualbox); and <vm_name> is a name of a virtual machine, configured for testing. Example: --vm "172.16.1.100;WIN10_1809_EN"; --vm "virtualbox;WIN10_1809_EN"
--package	Mandatory	Defines a path to the package that will be tested. Example: --package "C:\Packages\package.msix"
--output-report	Mandatory	Defines a path and a name of the testing report. Example: --output-report "C:\Reports\report.html"
--vm-restore	Optional	Defines if the virtual machine will be restored to the previous state after the testing completion. If not specified, the virtual machine will be restored. Supported values: "yes" - restore "no" - do not restore Example: --vm-restore "no"

---

Note

PACE Suite covers the whole range of application packaging tasks - learn more.

Try PACE Suite for free - 21 days no obligations unlimited trial with all functions unlocked.