Running the Workflow 2013 assessment is just like running any other adoption or deprecation 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 Workflow the Microsoft 365 Assessment tool will run the Workflow 2013 assessment for you. This page provides you with a quick start and links to the relevant Microsoft 365 Assessment tool documentation for more details.
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.
The Microsoft 365 Assessment tool requires an Azure AD application for authenticating to SharePoint. More details in the authentication documentation.
Below are some quick start samples that show how to run a Workflow 2013 assessment. More details on the Start action can be found in the Microsoft 365 Assessment tool Start documentation.
| Task | CLI |
|---|---|
| Start a new Workflow 2013 assessment (application permissions) for a complete tenant | microsoft365-assessment.exe start --mode Workflow --authmode application --tenant bertonline.sharepoint.com --applicationid c545f9ce-1c11-440b-812b-0b35217d9e83 --certpath "My|CurrentUser|b133d1cb4d19ce539986c7ac67de005481084c84" |
| Start a new Workflow 2013 assessment (delegated permissions) for a set of site collections | microsoft365-assessment.exe start --mode Workflow --authmode interactive --tenant bertonline.sharepoint.com --siteslist "https://bertonline.sharepoint.com/sites/ussales,https://bertonline.sharepoint.com/sites/europesales" |
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 |
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" |
To better understand the generated Power BI report and accompanying CSV files use the nodes in the left navigation.