Skip to main content
Version: 3.0.0-preview

Install-MaesterTests

SYNOPSIS​

Prepares a folder for your own Maester tests and configuration.

SYNTAX​

Install-MaesterTests [[-Path] <String>] [-SkipPesterCheck] [-ProgressAction <ActionPreference>]
[<CommonParameters>]

DESCRIPTION​

From Maester 3.0 the tests that ship with Maester run from the module itself, so updating the module updates them and nothing needs to be copied. Install-MaesterTests prepares a folder for your custom tests and configuration: it writes Custom/README.md and a starter maester-config.json when they are missing. It never writes a test file and never overwrites an existing file, so it is safe to call on every pipeline run.

Run Invoke-Maester -Path <folder> to run the built-in tests together with the custom tests in it.

EXAMPLES​

EXAMPLE 1​

Install-MaesterTests -Path ./maester-tests

Creates ./maester-tests with Custom/README.md and maester-config.json.

PARAMETERS​

-Path​

The folder to prepare. Defaults to the current directory.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: .
Accept pipeline input: False
Accept wildcard characters: False

-SkipPesterCheck​

No longer has any effect. Maester 3.0 does not install Pester; install it yourself only if you run Pester-format custom tests.

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.

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.

INPUTS​

OUTPUTS​

NOTES​

https://maester.dev/docs/commands/Install-MaesterTests