Main Content

Manage Polyspace Access Results and Users at the Command Line

Use the polyspace-access command to manage Polyspace Access results and users at the command line. For information and examples of using polyspace-access, see these command reference pages.

Note

The polyspace-access command is available in polyspaceroot\polyspace\bin. Here, polyspaceroot is the Polyspace® Server installation folder, for instance, C:\Program Files\Polyspace Server\R2025a (see also Installation Folder (Polyspace Bug Finder)). Polyspace Server and Polyspace Access™ are separate products. To avoid typing the full path to this command, add this location to the PATH environment variable in your operating system.

Manage and Review Projects

CommandDescription
polyspace-access -create-projectCreate a project folder in the Polyspace Access web interface
polyspace-access -move-projectMove or rename a project or folder
polyspace-access -delete-projectDelete specified project or folder
polyspace-access -set-deletion-policySet or edit the project run deletion policy for the specified project
polyspace-access -unset-deletion-policyUnset the project run deletion policy for the specified project
polyspace-access -get-deletion-policyShow the deletion policy for the specified project
polyspace-access -list-projectList the paths to all projects in the Polyspace Access database
polyspace-access -list-runsShow all the runs uploaded for the specified project
polyspace-access -set-project-informationDisplay and edit project information such as banner text
polyspace-access -unset-project-informationRemove project specific information such as banner text

Upload, Download, or Export Results

CommandDescription
polyspace-access -uploadUpload a Polyspace Bug Finder, Polyspace Code Prover, or Polyspace Test result to the Polyspace Access database.
polyspace-access -exportExport project results from the Polyspace Access database
polyspace-access -downloadDownload results from Polyspace Access

Manage Review Information for Findings

CommandDescription
polyspace-access -reviewEdit the information in the review fields of findings for a project
polyspace-access -import-reviewsImport review information from a source project to a target project in Polyspace Access

Manage Software Quality Objectives

CommandDescription
polyspace-access -set-sqoAssign an SQO level to the specified project
polyspace-access -get-sqoShow the currently assigned SQO level and SQO definition for the specified project
polyspace-access -list-sqoList the names of all available SQO

Manage Project Run Labels and Unassigned Findings

CommandDescription
polyspace-access -add-labelAdd a label to the project run
polyspace-access -remove-labelRemove a specified label from the project run
polyspace-access -set-unassigned-findingsAssign owners to unassigned results in a project in the Polyspace Access database

Manage User Permissions

CommandDescription
polyspace-access -set-roleAssign a role to a user for a specified project or project folder
polyspace-access -unset-roleRemove any role previously assigned to a user for the specified project or folder

Migrate Results from Polyspace Web Metrics

CommandDescription
polyspace-access -generate-migration-commandsGenerate scripts to migrate projects from Polyspace Metrics to Polyspace Access
polyspace-access -migrateMigrate projects from Polyspace Metrics to Polyspace Access using the scripts generated with the -generate-migration-commands command

Other Commands

CommandDescription
polyspace-access -verDisplay the version and license number of the specified Polyspace Access instance
polyspace-access -encrypt-passwordEncrypt the password you use to log into Polyspace Access