Microsoft-Secure-Score-Assessment-Toolkit

2.1.0

A powerful PowerShell toolkit for assessing Microsoft 365 security posture through the Microsoft Secure Score API. Generate comprehensive, interactive HTML reports with 411+ security controls directly from Microsoft Graph API. Features include real-time data fetching, interactive filtering, floating action buttons, and direct links to configuration portals. Perfect fo
A powerful PowerShell toolkit for assessing Microsoft 365 security posture through the Microsoft Secure Score API. Generate comprehensive, interactive HTML reports with 411+ security controls directly from Microsoft Graph API. Features include real-time data fetching, interactive filtering, floating action buttons, and direct links to configuration portals. Perfect for security assessments, compliance reporting, and continuous security monitoring.
Show more

Minimum PowerShell version

5.1

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name Microsoft-Secure-Score-Assessment-Toolkit

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name Microsoft-Secure-Score-Assessment-Toolkit

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2025 Mohammed Siddiqui. All rights reserved. MIT License.

Package Details

Author(s)

  • Mohammed Siddiqui

Tags

Microsoft365 M365 SecureScore Security Compliance Audit Assessment Graph GraphAPI SecurityCompliance SecurityAssessment SecurityPosture CyberSecurity GRC RiskManagement SecurityControls EntraID AzureAD Defender Purview Intune

Functions

Connect-MicrosoftSecureScore Invoke-MicrosoftSecureScore Get-MicrosoftSecureScoreInfo

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

v2.1.0 Category Filtering Feature

NEW FEATURES
ExcludeCategories Parameter: Filter out unwanted control categories from reports
 - Skip specific categories like Exchange, SharePoint, Teams, etc.
 - Supports multiple categories: -ExcludeCategories @("Exchange", "SharePoint")
 - ValidateSet with tab-completion for valid categories
 - Enhanced logging shows excluded categories and filtered control counts
 - Valid categories: Identity, Defender, Exchange, SharePoint, Groups, Teams, Compliance, Intune

IMPROVEMENTS
Better report filtering visibility with category exclusion counts
Log output displays excluded categories at assessment start
Summary includes total controls excluded by category filter

v2.0.2 Repository URL Updates

Updated all URLs to match renamed GitHub repository Microsoft Secure Score Assessment Toolkit.

v2.0.1 PowerShell Gallery Package Fix

Ensures modern template is included in PowerShell Gallery package.

v2.0.0 Major Architecture Refactoring and Modern UI

BREAKING CHANGES
Complete code refactoring with modular architecture
Enhanced modern dashboard UI with gradient design and animations

NEW FEATURES
Modular Architecture: Separated into Core, Processors, Reports, Templates, and Config directories
File based Logging: New LogPath parameter for audit trails
Template System: Maintainable HTML CSS JS files
Config Management: URL mappings in JSON with 60+ mappings
Modern UI: Circular score visualization, filter buttons, search functionality, animations
HTML Processing: Converts API HTML to readable text with proper formatting

IMPROVEMENTS
GraphApiClient, ComplianceProcessor, UrlProcessor, HtmlReportGenerator, Logger modules
Error handling with try catch blocks throughout
Session state management for module reloads
Comprehensive HTML entity decoding

FIXED
HTML tags displaying in descriptions
Module reload preserves Graph connection context
Empty string handling with fallback messages

Full changelog at https://github.com/mohammedsiddiqui6872/Microsoft-Secure-Score-Assessment-Toolkit/blob/main/CHANGELOG.md

FileList

Version History

Version Downloads Last updated
2.1.0 (current version) 24 2/1/2026
2.0.2 242 12/9/2025