Get-CommandHistory

SYNOPSIS

Get a filtered and de-duplicated list of commands from your history.

SYNTAX

BasicFilter (Default)

Get-CommandHistory [-Exclude <String[]>] [-Filter <String[]>]
 [<CommonParameters>]

NoFilter

Get-CommandHistory [-All] [-Exclude <String[]>] [-Filter <String[]>]
 [<CommonParameters>]

DESCRIPTION

This function filters the output of Get-History to exclude a list of ignored commands and any commands that are less than 4 characters long. It can also be used to find all commands that match a given pattern. It is useful for quickly finding things from your history that you want to document or re-invoke.

EXAMPLES

EXAMPLE 1

Get-CommandHistory -Filter 'Disk'

This will return all commands from your history that contain the word 'Disk'.

EXAMPLE 2

Get-CommandHistory -Exclude 'Get-Service', 'Get-Process'

This will return all commands from your history that do not contain the words 'Get-Service' or 'Get-Process' (while also still filtering out the default ignore list).

EXAMPLE 3

Get-CommandHistory -All

This will return all commands from your history without any filtering.

PARAMETERS

-All

Show all command history without filtering anything out.

Type: SwitchParameter
Parameter Sets: NoFilter
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Exclude

A string or array of strings to exclude. Commands that have these words in them will be excluded from the history output. The default ignored commands are: Get-History, Invoke-CommandHistory, Get-CommandHistory, clear.

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

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

-Filter

A string or regex pattern to find in the command history. Commands that contain this pattern will be returned.

The Filter is passed to the -match operator, so it can be a simple string or a more complex regex pattern.

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

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, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable, and -ProgressAction. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

Microsoft.PowerShell.Commands.HistoryInfo[]

NOTES

Author: Sam Erde Version: 2.0.0 Modified: 2025-09-08

RELATED LINKS