# Compare-MtTestResult

Compares Maester test result JSON files

Source: https://maester.dev/docs/commands/Compare-MtTestResult

## SYNOPSIS

Compares Maester test result JSON files

## SYNTAX

### Directory

```powershell
Compare-MtTestResult [-BaseDir] <Object> [-ProgressAction <ActionPreference>] [<CommonParameters>]
```

### Files

```powershell
Compare-MtTestResult [-PriorTest] <Object> [-NewTest] <Object> [-ProgressAction <ActionPreference>]
 [<CommonParameters>]
```

## DESCRIPTION

Will compare the most recent two test result JSON outputs from prior Invoke-Maester
runs, or will accept any two test result JSON files and provide the tests that have changed.

## EXAMPLES

### EXAMPLE 1

```powershell
Compare-MtTestResult -BaseDir .\test-results
```

### EXAMPLE 2

```powershell
$tests = @{
    NewTest   = (Get-Content .\test-results\TestResults-2024-05-21-182925.json | ConvertFrom-Json)
PriorTest = (Get-Content .\test-results\TestResults-2024-05-20-182925.json | ConvertFrom-Json)
}
Compare-MtTestResult @tests
```

## PARAMETERS

### -BaseDir

Path to folder where test results are located.
The two newest results will be compared.

```yaml
Type: Object
Parameter Sets: Directory
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PriorTest

Path to the previous test result JSON-file to be used as a reference.

```yaml
Type: Object
Parameter Sets: Files
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -NewTest

Path to the newer test result JSON-file to be used as the current result.

```yaml
Type: Object
Parameter Sets: Files
Aliases:

Required: True
Position: 2
Default value: None
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

## RELATED LINKS

[https://maester.dev/docs/commands/Compare-MtTestResult](https://maester.dev/docs/commands/Compare-MtTestResult)