M365FoundationsCISReport.psd1
|
# # Module manifest for module 'M365FoundationsCISReport' # # Generated by: Douglas S. Rios (DrIOSx) # # Generated on: 3/25/2024 # @{ # Script module or binary module file associated with this manifest. RootModule = 'M365FoundationsCISReport.psm1' # Version number of this module. ModuleVersion = '0.1.5' # Supported PSEditions # CompatiblePSEditions = @() # ID used to uniquely identify this module GUID = '0d064bfb-d1ce-484b-a173-993b55984dc9' # Author of this module Author = 'Douglas S. Rios (DrIOSx)' # Company or vendor of this module CompanyName = 'CrticalSolutions Net LLC' # Copyright statement for this module Copyright = '(c) 2024 Douglas S. Rios (DrIOSx). All rights reserved.' # Description of the functionality provided by this module Description = 'Automated assessment of 50 CIS 365 Foundations v3.0.0 benchmark.' # Minimum version of the Windows PowerShell engine required by this module PowerShellVersion = '5.0' # Name of the Windows PowerShell host required by this module # PowerShellHostName = '' # Minimum version of the Windows PowerShell host required by this module # PowerShellHostVersion = '' # Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only. # DotNetFrameworkVersion = '' # Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only. # CLRVersion = '' # Processor architecture (None, X86, Amd64) required by this module # ProcessorArchitecture = '' # Modules that must be imported into the global environment prior to importing this module RequiredModules = @() # Assemblies that must be loaded prior to importing this module # RequiredAssemblies = @() # Script files (.ps1) that are run in the caller's environment prior to importing this module. # ScriptsToProcess = @() # Type files (.ps1xml) to be loaded when importing this module # TypesToProcess = @() # Format files (.ps1xml) to be loaded when importing this module # FormatsToProcess = @() # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess # NestedModules = @() # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export. FunctionsToExport = @('Get-AdminRoleUserLicense','Invoke-M365SecurityAudit','Sync-CISExcelAndCsvData') # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export. CmdletsToExport = @() # Variables to export from this module VariablesToExport = @() # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export. AliasesToExport = @() # DSC resources to export from this module DscResourcesToExport = @() # List of all modules packaged with this module # ModuleList = @() # List of all files packaged with this module # FileList = @() # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell. PrivateData = @{ PSData = @{ Prerelease = '' # Tags applied to this module. These help with module discovery in online galleries. # Tags = @() # A URL to the license for this module. LicenseUri = 'https://creativecommons.org/licenses/by-nc-sa/4.0/deed.en' # A URL to the main website for this project. ProjectUri = 'https://github.com/CriticalSolutionsNetwork/M365FoundationsCISReport' # A URL to an icon representing this module. IconUri = 'https://csn-source.s3.us-east-2.amazonaws.com/CSN-Icon.png' # ReleaseNotes of this module ReleaseNotes = '## [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. ' } # End of PSData hashtable } # End of PrivateData hashtable # HelpInfo URI of this module # HelpInfoURI = '' # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix. # DefaultCommandPrefix = '' } |