Get started with Raidiness

Before you start

You need PowerShell 7.2 or newer for the core module. Some optional workload modules need a newer PowerShell version or Windows. You also need approved access to the tenant you want to check. Installing Raidiness doesn't give you that.

Start with Microsoft Graph and only add workloads when your assessment needs them. Check consent requests against your organization's policy, and pick an approved folder for the results.

Install Raidiness

Install the published module for your own user:

Install-Module Raidiness -Scope CurrentUser

Check which version you have and look at the command help:

Get-Module -ListAvailable Raidiness |
    Select-Object Name, Version
Get-Help Invoke-Raidiness -Full

You'll find all published versions on PowerShell Gallery. Only add -AllowPrerelease if you want a prerelease on purpose.

Which command should you use?

That depends on your version. In the published 0.4.5 release, you run a full assessment with Invoke-RaidinessCheckup. In 0.5, which I'm working on now, that becomes simply Invoke-Raidiness.

Published version (0.4.5)

For 0.4.5, use the full checkup command:

Invoke-RaidinessCheckup -TenantId 'contoso.onmicrosoft.com' -Customer 'Contoso' -Modules MsGraph

Do note that in 0.4.5, Invoke-Raidiness only does the collection and stops there. The report and the intake also work differently from 0.5, so follow the help for the version you installed. You can view the published 0.4.5 checkup command on PowerShell Gallery.

Development version (0.5)

If you have a 0.5 build, start with:

Invoke-Raidiness

It walks you through everything. It offers extra workloads, checks the local requirements, asks where to save the output and lets you fill in the intake in a CSV or JSON file. Then it signs in where needed, collects the data and builds the report.

For customer work, I recommend naming the tenant explicitly:

Invoke-Raidiness -TenantId 'contoso.onmicrosoft.com' -Customer 'Contoso'

This describes 0.5 as it is in my source code today. The latest stable package on PowerShell Gallery doesn't necessarily include these changes yet.

Add only the workloads you need

Microsoft Graph is the core. Optional modules add Exchange Online and Purview, Teams, SharePoint or Power Platform. Each one needs its own management module and sign-in.

The SharePoint and Power Platform adapters currently need Windows, so check the requirements of your installed version first. Tip: the local prerequisite check only looks at your own machine. It doesn't check remote permissions, consent or licensing.

Reading the report

Start with the findings, and with what couldn't be collected. Not measured means there wasn't enough data to judge that check. Look at the reason before you draw a conclusion.

In 0.5, you get the report as HTML, printable HTML, Markdown, JSON and a CSV. The CSV is still called action-list.csv, but it contains findings, not recommendations. Older versions export differently.

Reports can contain tenant and personal information, so store them somewhere approved and review them before you share anything. The default Documents folder may be synced to OneDrive. Use -Path to pick a different location.

Want to know the approach behind the commands? Read my AI Readiness Check. Found a bug or have feedback? Get in touch, and include the module version and a cleaned-up error message rather than a full tenant export.