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>]

ALIASES¶

This cmdlet has the following aliases, {{Insert list of aliases}}

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: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: NoFilter
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-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: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-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: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters¶

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS¶

OUTPUTS¶

Microsoft.PowerShell.Commands.HistoryInfo¶

NOTES¶

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