Skip to main content
Version: 3.0.0-preview

Get-MtPack

SYNOPSIS​

Lists the Maester Packs this folder runs: those that ship with Maester and those in maester-packs.lock.json, with whether each can run.

SYNTAX​

Get-MtPack [[-Id] <String[]>] [-PackLock <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

Each pack goes through the same checks Invoke-Maester applies before it loads a pack, and nothing of the pack is run: the config, the store and its digest, the pack policy, the blocklist and the digests of its modules. Status is Ready, Disabled, Unavailable, NotAllowed, Blocked or Failed, and Reason says why a pack will not run.

EXAMPLES​

EXAMPLE 1​

Get-MtPack

Lists the packs by their code, the start of each of their test IDs: Invoke-Maester -Pack <code> runs one.

EXAMPLE 2​

Get-MtPack | Format-Table Id, Version, Status, Reason

Shows which packs the next Invoke-Maester in this folder runs.

PARAMETERS​

-Id​

Only these packs: IDs or '*' wildcards.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-PackLock​

The lock file to read. By default the one beside the Maester config found from the current folder, else the user's.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
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.

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​

System.Management.Automation.PSObject​

NOTES​

https://maester.dev/docs/commands/Get-MtPack