M365FoundationsCISReport

0.1.5

Automated assessment of 50 CIS 365 Foundations v3.0.0 benchmark.

Minimum PowerShell version

5.0

Installation Options

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

Install-Module -Name M365FoundationsCISReport -RequiredVersion 0.1.5

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

Install-PSResource -Name M365FoundationsCISReport -Version 0.1.5

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) 2024 Douglas S. Rios (DrIOSx). All rights reserved.

Package Details

Author(s)

  • Douglas S. Rios (DrIOSx)

Functions

Get-AdminRoleUserLicense Invoke-M365SecurityAudit Sync-CISExcelAndCsvData

Dependencies

This module has no dependencies.

Release Notes

## [0.1.5] - 2024-06-08

### Added

- Updated test definitions for CIS Microsoft 365 Foundations Benchmark for better error handling and object output when errors occur.
- Added a parameter to the `Initialize-CISAuditResult` function to allow for a static failed object to be created when an error occurs.
- Refactored `Invoke-M365SecurityAudit` to include a new private function `Invoke-TestFunction` for executing test functions and handling errors.
- Added a new private function `Measure-AuditResult` to calculate and display audit results.
- Enhanced error logging to capture failed test details and display them at the end of the audit.
- Added a private function `Get-RequiredModule` to initialize the `$requiredModules` variable for better code organization in the main script.
- Updated `Test-MailboxAuditingE3` and `Test-MailboxAuditingE5` functions to use `Format-MissingAction` for structuring missing actions into a pipe-separated table format.
- Added more verbose logging to `Test-BlockMailForwarding` and improved error handling for better troubleshooting.
- Improved `Test-RestrictCustomScripts` to handle long URL lengths better by extracting and replacing common hostnames, and provided detailed output.
- Added sorting to output.
- Created new functions for improved modularity.
- Parameter validation for Excel and CSV path in sync function.
- Added Output type to tests.
- Added `M365DomainForPWPolicyTest` parameter to `Invoke-M365SecurityAudit` to specify testing only the default domain for password expiration policy when '1.3.1' is included in the tests.

### Fixed

- Ensured the `Invoke-TestFunction` returns a `CISAuditResult` object, which is then managed in the `Invoke-M365SecurityAudit` function.
- Corrected the usage of the join operation within `$details` in `Test-BlockMailForwarding` to handle arrays properly.
- Fixed the logic in `Test-RestrictCustomScripts` to accurately replace and manage URLs, ensuring compliance checks are correctly performed.
- Updated the `Test-MailboxAuditingE3` and `Test-MailboxAuditingE5` functions to handle the `$allFailures` variable correctly, ensuring accurate pass/fail results.
- Fixed the connections in helper CSV and connect function.
- Removed verbose preference from `Test-RestrictCustomScripts`.
- Ensured that the output in `Test-BlockMailForwarding` does not include extra spaces between table headers and data.
- Fixed output in `Test-MailboxAuditingE3` and `Test-MailboxAuditingE5` to correctly align with the new table format.
- Added step 1 and step 2 in `Test-BlockMailForwarding` details to ensure comprehensive compliance checks.
- Fixed the issue with the output in `Test-RestrictCustomScripts` to ensure no extra spaces between table headers and data.



FileList

Version History

Version Downloads Last updated
0.1.26 513 8/4/2024
0.1.25 124 7/23/2024
0.1.24 11 7/7/2024
0.1.23 8 7/2/2024
0.1.22 6 7/1/2024
0.1.21 6 7/1/2024
0.1.20 6 6/30/2024
0.1.19 6 6/30/2024
0.1.18 6 6/30/2024
0.1.17 6 6/28/2024
0.1.16 8 6/27/2024
0.1.15 6 6/26/2024
0.1.14 9 6/24/2024
0.1.13 8 6/18/2024
0.1.12 9 6/17/2024
0.1.11 9 6/14/2024
0.1.10 6 6/12/2024
0.1.9 12 6/10/2024
0.1.8 9 6/9/2024
0.1.7 6 6/9/2024
0.1.6 6 6/8/2024
0.1.5 (current version) 6 6/8/2024
0.1.4 11 5/30/2024
0.1.3 6 5/29/2024
0.1.2 10 4/29/2024
0.1.1 13 4/2/2024
0.1.0-previe... 7 3/25/2024
Show less