# Merge-MtMaesterResult Merges multiple MaesterResults objects into a single multi-tenant result for combined HTML reporting. Source: https://maester.dev/docs/commands/Merge-MtMaesterResult ## SYNOPSIS Merges multiple MaesterResults objects into a single multi-tenant result for combined HTML reporting. ## SYNTAX ### FromObjects (Default) ```powershell Merge-MtMaesterResult [-MaesterResults] [-SameRun] [-ProgressAction ] [] ``` ### FromPath ```powershell Merge-MtMaesterResult [-Path] [-SameRun] [-ProgressAction ] [] ``` ## DESCRIPTION Takes an array of MaesterResults objects (each from a separate Invoke-Maester run against a different tenant) and combines them into a single object with a "Tenants" array. The resulting object can be passed to Get-MtHtmlReport to generate a multi-tenant report with a tenant selector in the sidebar. Accepts either in-memory MaesterResults objects (from Invoke-Maester -PassThru or pipeline) or file paths/directories that are loaded automatically via Import-MtMaesterResult. All results are included as-is - no deduplication is performed when the same TenantId appears multiple times. This is by design to support future scenarios such as historical trend reports where multiple runs from the same tenant are intentional. ## EXAMPLES ### EXAMPLE 1 ```powershell # Merge from file paths (one-liner) Merge-MtMaesterResult -Path ./production.json, ./development.json | Get-MtHtmlReport | Out-File report.html ``` ### EXAMPLE 2 ```powershell # Merge from a directory of JSON files Merge-MtMaesterResult -Path ./results/ | Get-MtHtmlReport | Out-File report.html ``` ### EXAMPLE 3 ```powershell # Merge from a glob pattern Merge-MtMaesterResult -Path *.json | Get-MtHtmlReport | Out-File report.html ``` ### EXAMPLE 4 ```powershell # Pipeline: Import then merge Import-MtMaesterResult -Path *.json | Merge-MtMaesterResult | Get-MtHtmlReport | Out-File report.html ``` ### EXAMPLE 5 ```powershell # In-memory: run against two tenants and merge $result1 = Invoke-Maester -PassThru # ... reconnect to second tenant ... $result2 = Invoke-Maester -PassThru ``` $merged = Merge-MtMaesterResult -MaesterResults @($result1, $result2) $html = Get-MtHtmlReport -MaesterResults $merged $html | Out-File -FilePath "MultiTenantReport.html" -Encoding UTF8 ### EXAMPLE 6 ```powershell # Merge the partial results of one run split across two processes Merge-MtMaesterResult -Path ./graph.json, ./exchange.json -SameRun | Get-MtHtmlReport | Out-File report.html ``` ## PARAMETERS ### -MaesterResults An array of MaesterResults objects, each representing test results from a different tenant. Accepts pipeline input from Import-MtMaesterResult. ```yaml Type: PSObject[] Parameter Sets: FromObjects Aliases: Required: True Position: 1 Default value: None Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -Path One or more paths to JSON result files, glob patterns, or directories. Files are loaded via Import-MtMaesterResult internally. - File path: ./production.json - Glob: ./results/*.json - Directory: ./results/ (discovers TestResults-*.json inside) ```yaml Type: String[] Parameter Sets: FromPath Aliases: Required: True Position: 1 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SameRun Merges partial results of one run instead of building a multi-tenant report. Use it when a run was split across processes or containers (for example Invoke-Maester -TestId with different IDs in each, all with the same Metadata.RunId and module version). The rows are united by test ID: a row that ran (any result other than NotRun) replaces a NotRun row for the same ID, so the rows each partition reports for tests it did not select are dropped where another partition ran them. The counts, blocks and run result are recomputed, and each partial result's tenant, timing and command are kept under Partitions. All results must have the same CatalogVersion, and the same RunMetadata.RunId when they have one. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: False Accept pipeline input: False Accept wildcard characters: False ``` ### -ProgressAction Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress. ```yaml Type: ActionPreference Parameter Sets: (All) Aliases: proga Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ## OUTPUTS ## NOTES ## Design notes for future development ### Multi-tenant reports (current) This command wraps all results into a Tenants[] array. The HTML report frontend detects the Tenants property and renders a tenant selector in the sidebar. No deduplication is performed - if the same TenantId appears multiple times, all instances are included. ### Historical / trend reports (planned) A future command (e.g. New-MtTrendReport) can reuse Import-MtMaesterResult to load results, then group by TenantId and sort by ExecutedAt within each group. Each result already carries TenantId and ExecutedAt, so the intelligence is: - Different TenantIds, similar dates -> multi-tenant (use Merge-MtMaesterResult) - Same TenantId, different dates -> historical trend (use future trend command) - Mixed -> group by TenantId, each group has a timeline Import-MtMaesterResult is intentionally a "dumb loader" that returns everything. The consuming command (Merge, Compare, Trend) decides how to interpret the data. ### Pipeline architecture The intended pipeline pattern is: Import-MtMaesterResult -> [Merge | Compare | Trend] -> Get-MtHtmlReport -> Out-File Merge-MtMaesterResult also accepts -Path directly for convenience (calls Import internally), so the user can skip the Import step for simple scenarios: Merge-MtMaesterResult -Path *.json | Get-MtHtmlReport | Out-File report.html ## RELATED LINKS [https://maester.dev/docs/commands/Merge-MtMaesterResult](https://maester.dev/docs/commands/Merge-MtMaesterResult)