Run a classic pages assessment
Running the classic pages assessment is just like running any other module of the Microsoft 365 Assessment tool: you use the CLI with the Start action to launch an assessment. By specifying the --mode to be Classic (and including the Pages component) the Microsoft 365 Assessment tool will run the classic pages assessment for you. This page provides you with a quick start and links to the relevant Microsoft 365 Assessment tool documentation for more details.
Note
The classic pages assessment is available as of version 1.15.0 of the Microsoft 365 Assessment tool. Within a Classic assessment the Azure ACS and SharePoint Add-Ins components are skipped (they are provided by the dedicated --mode AddInsACS module).
Quick start
Download the Microsoft 365 Assessment tool
The Microsoft 365 Assessment tool must first be downloaded from https://github.com/pnp/pnpassessment/releases. More details can be found in the download documentation.
Ensure you've an Entra application setup
The Microsoft 365 Assessment tool requires an Entra application for authenticating to SharePoint. More details in the authentication documentation.
Start assessment
Below are some quick start samples that show how to run a classic pages assessment. More details on the Start action can be found in the Microsoft 365 Assessment tool Start documentation.
| Task | CLI |
|---|---|
| Start a new classic pages assessment (application permissions) for a complete tenant | microsoft365-assessment.exe start --mode Classic --classicinclude Pages --authmode application --tenant bertonline.sharepoint.com --applicationid c545f9ce-1c11-440b-812b-0b35217d9e83 --certpath "My|CurrentUser|b133d1cb4d19ce539986c7ac67de005481084c84" |
| Start a classic pages assessment for a set of site collections | microsoft365-assessment.exe start --mode Classic --classicinclude Pages --authmode interactive --tenant bertonline.sharepoint.com --applicationid c545f9ce-1c11-440b-812b-0b35217d9e83 --siteslist "https://bertonline.sharepoint.com/sites/ussales,https://bertonline.sharepoint.com/sites/europesales" |
| Assess only the home page of each web, exporting web part properties | microsoft365-assessment.exe start --mode Classic --classicinclude Pages --homepageonly --exportwebpartproperties --authmode application --tenant bertonline.sharepoint.com --applicationid c545f9ce-1c11-440b-812b-0b35217d9e83 --certpath "My|CurrentUser|b133d1cb4d19ce539986c7ac67de005481084c84" |
See the requirements page for the full list of classic page-scan arguments (--exportwebpartproperties, --skipusageinformation, --skipuserinformation, --homepageonly).
--homepageonly applies to both discovery and page assessment. The tool resolves each web's configured welcome page directly and assesses that physical file, without enumerating every list, folder, form and view in the web. Omit --homepageonly when the report must include the complete physical ASPX inventory for the selected tenant or sites.
Live status updates
Once an assessment is launched you'd typically followup on it's status via the Status action. Below is a quick start, more details can be found in the Microsoft 365 Assessment tool operations documentation.
| Task | CLI |
|---|---|
| Realtime status update of the running assessments | microsoft365-assessment.exe status |
Generate report
When an assessment has finished you can continue with the next step and that's generating the Power BI report by using the Report action. Below is a quick start, more details can be found in the Microsoft 365 Assessment tool Report documentation.
| Task | CLI |
|---|---|
| Generate Power BI report (includes CSV export) in the default location | microsoft365-assessment.exe report --id 22989c75-f08f-4af9-8857-6f19e333d6d3 |
| Export the gathered data as CSV files in a custom location | microsoft365-assessment.exe report --id 22989c75-f08f-4af9-8857-6f19e333d6d3 --mode CsvOnly --path "c:\reports" |
The CSV export includes discovery.csv, which lists physical ASPX files discovered within the requested page scope, inspected scopes, sanitized acquisition evidence and the final coverage verdict. Use its Scope and Gap rows to identify denied, failed, partial or otherwise incomplete discovery. The existing classicpages.csv continues to contain the classic pages selected for page assessment and modernization analysis.
Note
The value for the id parameter is the id of your assessment. You can get this by running the list command.
To better understand the generated Power BI report and accompanying CSV files use the nodes in the left navigation.